|
Packit |
1470ea |
|
|
Packit |
1470ea |
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="tooltip.c" xml:lang="de">
|
|
Packit |
1470ea |
<info>
|
|
Packit |
1470ea |
<title type="text">Tooltip (C)</title>
|
|
Packit |
1470ea |
<link type="guide" xref="c#misc"/>
|
|
Packit |
1470ea |
<link type="seealso" xref="toolbar.c"/>
|
|
Packit |
1470ea |
<revision version="0.1" date="2013-07-02" status="review"/>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<credit type="author copyright">
|
|
Packit |
1470ea |
<name>Tiffany Antopolski</name>
|
|
Packit |
1470ea |
<email its:translate="no">tiffany.antopolski@gmail.com</email>
|
|
Packit |
1470ea |
<years>2013</years>
|
|
Packit |
1470ea |
</credit>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<desc>Add tips to your widgets</desc>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
|
|
Packit |
1470ea |
<mal:name>Mario Blättermann</mal:name>
|
|
Packit |
1470ea |
<mal:email>mario.blaettermann@gmail.com</mal:email>
|
|
Packit |
1470ea |
<mal:years>2011, 2013</mal:years>
|
|
Packit |
1470ea |
</mal:credit>
|
|
Packit |
1470ea |
</info>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<title>Tooltip</title>
|
|
Packit |
1470ea |
<media type="image" mime="image/png" src="media/tooltip.png"/>
|
|
Packit |
1470ea |
A toolbar with a tooltip (with an image) for a button.
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<note>This example builds on the <link xref="toolbar.c">Toolbar</link> example. </note>
|
|
Packit |
1470ea |
<links type="section"/>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<section id="code">
|
|
Packit |
1470ea |
<title>Code used to generate this example</title>
|
|
Packit |
1470ea |
#include <gtk/gtk.h>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
static gboolean
|
|
Packit |
1470ea |
undo_tooltip_callback (GtkStatusIcon *status_icon,
|
|
Packit |
1470ea |
gint x,
|
|
Packit |
1470ea |
gint y,
|
|
Packit |
1470ea |
gboolean keyboard_mode,
|
|
Packit |
1470ea |
GtkTooltip *tooltip,
|
|
Packit |
1470ea |
gpointer user_data)
|
|
Packit |
1470ea |
{
|
|
Packit |
1470ea |
/* set the text for the tooltip */
|
|
Packit |
1470ea |
gtk_tooltip_set_text (tooltip, "Undo your last action");
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* set an icon fot the tooltip */
|
|
Packit |
1470ea |
gtk_tooltip_set_icon_from_stock(tooltip, "gtk-undo", GTK_ICON_SIZE_MENU);
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* show the tooltip */
|
|
Packit |
1470ea |
return TRUE;
|
|
Packit |
1470ea |
}
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
static void
|
|
Packit |
1470ea |
undo_callback (GSimpleAction *simple,
|
|
Packit |
1470ea |
GVariant *parameter,
|
|
Packit |
1470ea |
gpointer user_data)
|
|
Packit |
1470ea |
{
|
|
Packit |
1470ea |
g_print ("You clicked \"Undo\".\n");
|
|
Packit |
1470ea |
}
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
static void
|
|
Packit |
1470ea |
activate (GtkApplication *app,
|
|
Packit |
1470ea |
gpointer user_data)
|
|
Packit |
1470ea |
{
|
|
Packit |
1470ea |
GtkWidget *grid;
|
|
Packit |
1470ea |
GtkWidget *window;
|
|
Packit |
1470ea |
GtkWidget *toolbar;
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
GtkToolItem *new_button;
|
|
Packit |
1470ea |
GtkToolItem *open_button;
|
|
Packit |
1470ea |
GtkToolItem *undo_button;
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
GtkStyleContext *style_context;
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
GSimpleAction *undo_action;
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
window = gtk_application_window_new (app);
|
|
Packit |
1470ea |
gtk_window_set_title (GTK_WINDOW (window), "Toolbar with Tooltips Example");
|
|
Packit |
1470ea |
gtk_window_set_default_size (GTK_WINDOW (window), 400, 200);
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* Here we begin to create the toolbar */
|
|
Packit |
1470ea |
toolbar = gtk_toolbar_new ();
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* Set the toolbar to be the primary toolbar of the application */
|
|
Packit |
1470ea |
style_context = gtk_widget_get_style_context (toolbar);
|
|
Packit |
1470ea |
gtk_style_context_add_class (style_context, GTK_STYLE_CLASS_PRIMARY_TOOLBAR);
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* Create a button for the "new" action, with a stock image */
|
|
Packit |
1470ea |
new_button = gtk_tool_button_new_from_stock (GTK_STOCK_NEW);
|
|
Packit |
1470ea |
gtk_tool_item_set_is_important (new_button, TRUE);
|
|
Packit |
1470ea |
gtk_toolbar_insert (GTK_TOOLBAR (toolbar), new_button, 0);
|
|
Packit |
1470ea |
gtk_widget_show (GTK_WIDGET (new_button));
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* Set the action name for the "new" action. We use "app.new" to
|
|
Packit |
1470ea |
* indicate that the action controls the application.
|
|
Packit |
1470ea |
*/
|
|
Packit |
1470ea |
gtk_actionable_set_action_name (GTK_ACTIONABLE (new_button), "app.new");
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/*******************************
|
|
Packit |
1470ea |
* Tooltip for the New ToolItem:
|
|
Packit |
1470ea |
* a tooltip with text
|
|
Packit |
1470ea |
*******************************/
|
|
Packit |
1470ea |
gtk_tool_item_set_tooltip_text (new_button, "Create a new file");
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* "Open" */
|
|
Packit |
1470ea |
open_button = gtk_tool_button_new_from_stock (GTK_STOCK_OPEN);
|
|
Packit |
1470ea |
gtk_tool_item_set_is_important (open_button, TRUE);
|
|
Packit |
1470ea |
gtk_toolbar_insert (GTK_TOOLBAR (toolbar), open_button, 1);
|
|
Packit |
1470ea |
gtk_widget_show (GTK_WIDGET (open_button));
|
|
Packit |
1470ea |
gtk_actionable_set_action_name (GTK_ACTIONABLE (open_button), "app.open");
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/*******************************
|
|
Packit |
1470ea |
* Tooltip for the Open ToolItem:
|
|
Packit |
1470ea |
* a tooltip using Pango markup
|
|
Packit |
1470ea |
* language
|
|
Packit |
1470ea |
*******************************/
|
|
Packit |
1470ea |
gtk_tool_item_set_tooltip_text (open_button, "Open an <i>existing</i> file");
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* "Undo" */
|
|
Packit |
1470ea |
undo_button = gtk_tool_button_new_from_stock (GTK_STOCK_UNDO);
|
|
Packit |
1470ea |
gtk_tool_item_set_is_important (undo_button, TRUE);
|
|
Packit |
1470ea |
gtk_toolbar_insert (GTK_TOOLBAR (toolbar), undo_button, 2);
|
|
Packit |
1470ea |
gtk_widget_show (GTK_WIDGET (undo_button));
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* In this case, we use "win.undo" to indicate that
|
|
Packit |
1470ea |
* the action controls only the window
|
|
Packit |
1470ea |
*/
|
|
Packit |
1470ea |
gtk_actionable_set_action_name (GTK_ACTIONABLE (undo_button), "win.undo");
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/*******************************
|
|
Packit |
1470ea |
* Tooltip for the Undo ToolItem:
|
|
Packit |
1470ea |
* a tooltip with an image
|
|
Packit |
1470ea |
*******************************/
|
|
Packit |
1470ea |
gtk_widget_set_has_tooltip (GTK_WIDGET (undo_button), TRUE);
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
// Next, we connect the query_tooltip signal
|
|
Packit |
1470ea |
g_signal_connect (undo_button, "query-tooltip", G_CALLBACK (undo_tooltip_callback), NULL);
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
gtk_widget_set_hexpand (toolbar, TRUE);
|
|
Packit |
1470ea |
gtk_widget_show (toolbar);
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
grid = gtk_grid_new ();
|
|
Packit |
1470ea |
gtk_grid_attach (GTK_GRID (grid), toolbar, 0, 0, 1, 1);
|
|
Packit |
1470ea |
gtk_container_add (GTK_CONTAINER (window), GTK_WIDGET (grid));
|
|
Packit |
1470ea |
gtk_widget_show (GTK_WIDGET (grid));
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* Use the action names to create the actions that control the window, and
|
|
Packit |
1470ea |
* connect them to the appropriate callbackfunctions.
|
|
Packit |
1470ea |
*/
|
|
Packit |
1470ea |
undo_action = g_simple_action_new ("undo", NULL);
|
|
Packit |
1470ea |
g_signal_connect (undo_action, "activate", G_CALLBACK (undo_callback),
|
|
Packit |
1470ea |
GTK_WINDOW (window));
|
|
Packit |
1470ea |
g_action_map_add_action (G_ACTION_MAP (window), G_ACTION (undo_action));
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
gtk_widget_show (window);
|
|
Packit |
1470ea |
}
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* Callback function for the new action */
|
|
Packit |
1470ea |
static void
|
|
Packit |
1470ea |
new_callback (GSimpleAction *simple,
|
|
Packit |
1470ea |
GVariant *parameter,
|
|
Packit |
1470ea |
gpointer user_data)
|
|
Packit |
1470ea |
{
|
|
Packit |
1470ea |
g_print ("You clicked \"New\".\n");
|
|
Packit |
1470ea |
}
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* Callback function for the open action */
|
|
Packit |
1470ea |
static void
|
|
Packit |
1470ea |
open_callback (GSimpleAction *simple,
|
|
Packit |
1470ea |
GVariant *parameter,
|
|
Packit |
1470ea |
gpointer user_data)
|
|
Packit |
1470ea |
{
|
|
Packit |
1470ea |
g_print ("You clicked \"Open\".\n");
|
|
Packit |
1470ea |
}
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* In this function, we create the actions in which control the window, and
|
|
Packit |
1470ea |
* connect their signals to the appropriate callback function.
|
|
Packit |
1470ea |
*/
|
|
Packit |
1470ea |
static void
|
|
Packit |
1470ea |
startup (GApplication *app,
|
|
Packit |
1470ea |
gpointer user_data)
|
|
Packit |
1470ea |
{
|
|
Packit |
1470ea |
GSimpleAction *new_action;
|
|
Packit |
1470ea |
GSimpleAction *open_action;
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
new_action = g_simple_action_new ("new", NULL);
|
|
Packit |
1470ea |
g_signal_connect (new_action, "activate", G_CALLBACK (new_callback), app);
|
|
Packit |
1470ea |
g_action_map_add_action (G_ACTION_MAP (app), G_ACTION (new_action));
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
open_action = g_simple_action_new ("open", NULL);
|
|
Packit |
1470ea |
g_signal_connect (open_action, "activate", G_CALLBACK (open_callback), app);
|
|
Packit |
1470ea |
g_action_map_add_action (G_ACTION_MAP (app), G_ACTION (open_action));
|
|
Packit |
1470ea |
}
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
/* Startup function for the application */
|
|
Packit |
1470ea |
int
|
|
Packit |
1470ea |
main (int argc, char **argv)
|
|
Packit |
1470ea |
{
|
|
Packit |
1470ea |
GtkApplication *app;
|
|
Packit |
1470ea |
int status;
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
app = gtk_application_new ("org.gtk.example", G_APPLICATION_FLAGS_NONE);
|
|
Packit |
1470ea |
g_signal_connect (app, "activate", G_CALLBACK (activate), NULL);
|
|
Packit |
1470ea |
g_signal_connect (app, "startup", G_CALLBACK (startup), NULL);
|
|
Packit |
1470ea |
status = g_application_run (G_APPLICATION (app), argc, argv);
|
|
Packit |
1470ea |
g_object_unref (app);
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
return status;
|
|
Packit |
1470ea |
}
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
</section>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<section id="references">
|
|
Packit |
1470ea |
<title>API-Referenzen</title>
|
|
Packit |
1470ea |
In this sample we used the following:
|
|
Packit |
1470ea |
<list>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/stable/GtkTooltip.html">GtkTooltip</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/stable/GtkToolbar.html">GtkToolbar</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/stable/GtkWidget.html">GtkWidget</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/stable/gtk3-Stock-Items.html">Stock Items</link> </item>
|
|
Packit |
1470ea |
</list>
|
|
Packit |
1470ea |
</section>
|
|
Packit |
1470ea |
</page>
|