# Συμβουλή οθόνης (C)

Tiffany Antopolski
tiffany.antopolski@gmail.com 2013
Προσθέστε συμβουλές στα γραφικά στοιχεία σας
Ελληνική μεταφραστική ομάδα GNOME
team@gnome.gr 2012-2015
Δημήτρης Σπίγγος
dmtrs32@gmail.com 2012, 2013
Μαρία Θουκιδίδου
marablack3@gmail.com 2014
Θάνος Τρυφωνίδης
tomtryf@gmail.com 2014, 2015

# Συμβουλή οθόνης

Μια εργαλειοθήκη με μια συμβουλή οθόνης (με μια εικόνα) για ένα κουμπί.

Αυτό το παράδειγμα δομεί στο παράδειγμα εργαλειοθήκη.

# Ο χρησιμοποιούμενος κώδικας για παραγωγή αυτού παραδείγματος

#include <gtk/gtk.h>

static gboolean undo_tooltip_callback (GtkStatusIcon *status_icon, gint x, gint y, gboolean keyboard_mode, GtkTooltip *tooltip, gpointer user_data) { /* Εισαγωγή του κειμένου για τη συμβουλή οθόνης */ gtk_tooltip_set_text (tooltip, "Undo your last action");

/* Εισαγωγή εικονιδίου για τη συμβουλή οθόνης */ gtk_tooltip_set_icon_from_stock(tooltip, "gtk-undo", GTK_ICON_SIZE_MENU);

/* εμφάνιση της συμβουλής οθόνης */ return TRUE; }

static void undo_callback (GSimpleAction *simple, GVariant *parameter, gpointer user_data) { g_print ("You clicked \"Undo\".\n"); }

static void activate (GtkApplication *app, gpointer user_data) { GtkWidget *grid; GtkWidget *window; GtkWidget *toolbar;

GtkToolItem *new_button; GtkToolItem *open_button; GtkToolItem *undo_button;

GtkStyleContext *style_context;

GSimpleAction *undo_action;

window = gtk_application_window_new (app); gtk_window_set_title (GTK_WINDOW (window), "Toolbar with Tooltips Example"); gtk_window_set_default_size (GTK_WINDOW (window), 400, 200);

/* Εδώ ξεκινά η δημιουργία της εργαλειοθήκης */ toolbar = gtk_toolbar_new ();

/* Ορισμός της εργαλειοθήκης να είναι η κύρια εργαλειοθήκη της εφαρμογής */ style_context = gtk_widget_get_style_context (toolbar); gtk_style_context_add_class (style_context, GTK_STYLE_CLASS_PRIMARY_TOOLBAR);

/* Δημιουργία κουμπιού για την ενέργεια "new", με μια έτοιμη εικόνα */ new_button = gtk_tool_button_new_from_stock (GTK_STOCK_NEW); gtk_tool_item_set_is_important (new_button, TRUE); gtk_toolbar_insert (GTK_TOOLBAR (toolbar), new_button, 0); gtk_widget_show (GTK_WIDGET (new_button));

/* Ορισμός του ονόματος της ενέργειας για την ενέργεια "new". * Χρησιμοποιούμε "app.new" για να δείξουμε ότι η ενέργεια ελέγχει την εφαρμογή. */ gtk_actionable_set_action_name (GTK_ACTIONABLE (new_button), "app.new");

/******************************* * Συμβουλή οθόνης για το νέο στοιχείο εργαλείων: * μια συμβουλή οθόνης με κείμενο *******************************/ gtk_tool_item_set_tooltip_text (new_button, "Create a new file");

/* "Open" */ open_button = gtk_tool_button_new_from_stock (GTK_STOCK_OPEN); gtk_tool_item_set_is_important (open_button, TRUE); gtk_toolbar_insert (GTK_TOOLBAR (toolbar), open_button, 1); gtk_widget_show (GTK_WIDGET (open_button)); gtk_actionable_set_action_name (GTK_ACTIONABLE (open_button), "app.open");

/******************************* * Συμβουλή οθόνης για το στοιχείο εργαλείων άνοιγμα: * μια συμβουλή οθόνης χρησιμοποιώντας * τη γλώσσας επισήμανσης Pango *******************************/ gtk_tool_item_set_tooltip_text (open_button, "Open an <i>existing</i> file");

/* "Undo" */ undo_button = gtk_tool_button_new_from_stock (GTK_STOCK_UNDO); gtk_tool_item_set_is_important (undo_button, TRUE); gtk_toolbar_insert (GTK_TOOLBAR (toolbar), undo_button, 2); gtk_widget_show (GTK_WIDGET (undo_button));

/* Σε αυτήν την περίπτωση, χρησιμοποιούμε "win.undo" για να * δείξουμε ότι η ενέργεια ελέγχει μόνο το παράθυρο */ gtk_actionable_set_action_name (GTK_ACTIONABLE (undo_button), "win.undo");

/******************************* * Συμβουλή οθόνης για το στοιχείο μενού αναίρεση: * μια συμβουλή οθόνης με μια εικόνα *******************************/ gtk_widget_set_has_tooltip (GTK_WIDGET (undo_button), TRUE);

// Κατόπιν, συνδέουμε το σήμα query_tooltip g_signal_connect (undo_button, "query-tooltip", G_CALLBACK (undo_tooltip_callback), NULL);

gtk_widget_set_hexpand (toolbar, TRUE); gtk_widget_show (toolbar);

grid = gtk_grid_new (); gtk_grid_attach (GTK_GRID (grid), toolbar, 0, 0, 1, 1); gtk_container_add (GTK_CONTAINER (window), GTK_WIDGET (grid)); gtk_widget_show (GTK_WIDGET (grid));

/* Χρησιμοποιήστε τα ονόματα ενέργειας για τη δημιουργία ενεργειών που ελέγχουν το παράθυρο και συνδέστε τες με τις κατάλληλες * συναρτήσεις επανάκλησης. */ undo_action = g_simple_action_new ("undo", NULL); g_signal_connect (undo_action, "activate", G_CALLBACK (undo_callback), GTK_WINDOW (window)); g_action_map_add_action (G_ACTION_MAP (window), G_ACTION (undo_action));

gtk_widget_show (window); }

/* Συνάρτηση επανάκλησης για τη νέα ενέργεια */ static void new_callback (GSimpleAction *simple, GVariant *parameter, gpointer user_data) { g_print ("You clicked \"New\".\n"); }

/* Συνάρτηση επανάκλησης για την ενέργεια ανοίγματος */ static void open_callback (GSimpleAction *simple, GVariant *parameter, gpointer user_data) { g_print ("You clicked \"Open\".\n"); }

/* Σε αυτήν τη συνάρτηση, δημιουργούμε τις ενέργειες που ελέγχουν το παράθυρο και * συνδέουν τα σήματά τους με την κατάλληλη συνάρτηση επανάκλησης. */ static void startup (GApplication *app, gpointer user_data) { GSimpleAction *new_action; GSimpleAction *open_action;

new_action = g_simple_action_new ("new", NULL); g_signal_connect (new_action, "activate", G_CALLBACK (new_callback), app); g_action_map_add_action (G_ACTION_MAP (app), G_ACTION (new_action));

open_action = g_simple_action_new ("open", NULL); g_signal_connect (open_action, "activate", G_CALLBACK (open_callback), app); g_action_map_add_action (G_ACTION_MAP (app), G_ACTION (open_action)); }

/* Συνάρτηση έναρξης για την εφαρμογή */ int main (int argc, char **argv) { GtkApplication *app; int status;

app = gtk_application_new ("org.gtk.example", G_APPLICATION_FLAGS_NONE); g_signal_connect (app, "activate", G_CALLBACK (activate), NULL); g_signal_connect (app, "startup", G_CALLBACK (startup), NULL); status = g_application_run (G_APPLICATION (app), argc, argv); g_object_unref (app);

return status; }

# Αναφορές API

Σε αυτό το παράδειγμα χρησιμοποιήσαμε τα παρακάτω:

GtkTooltip

GtkToolbar

GtkWidget

Stock Items