<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="toolbar.c" xml:lang="cs">

  <info>

    <title type="text">Toolbar (C)</title>

    <link type="guide" xref="c#menu-combo-toolbar"/>

    <link type="seealso" xref="menubar.c"/>

    <link type="seealso" xref="grid.c"/>

    <revision version="0.1" date="2012-08-19" status="draft"/>

    <credit type="author copyright">

      <name>Monica Kochofar</name>

      <email its:translate="no">monicakochofar@gmail.com</email>

      <years>2012</years>

    </credit>

    <desc>Lišta s tlačítky</desc>

  </info>

  <title>Toolbar</title>

  <media type="image" mime="image/png" src="media/toolbar.png"/>

  
Nástrojová lišta může obsahovat text nebo standardní ikony. V tomto příkladu používáme standardní ikony. Tento příklad obsahuje funkci pro zobrazení na celou obrazovku.

  
Tento příklad používá SimpleAction (jednoduchá akce), pro okno i pro aplikaci. Akci pro aplikaci lze snadno přidat do aplikační nabídky.

#include <gtk/gtk.h>

/* Deklaruje tato dvě nástrojová tlačítka, protože obě budou použita jak

 * ve zpětném volání akce „celá obrazovka“, tak v aktivační funkci

 */

GtkToolItem *fullscreen_button;

GtkToolItem *leavefullscreen_button;

/* Funkce zpětného volání pro akci „zpět“ */

static void

undo_callback (GSimpleAction *simple,

               GVariant      *parameter,

               gpointer       user_data)

{

  g_print ("You clicked \"Undo\".\n");

}

/* Funkce zpětného volání pro akci „celá obrazovka“ */

static void

fullscreen_callback (GSimpleAction *simple,

                     GVariant      *parameter,

                     gpointer       user_data)

{

  GdkWindow *window = gtk_widget_get_window (GTK_WIDGET (user_data));

  GdkWindowState current_state = gdk_window_get_state (window);

  /* Jestliže je okno právě v režimu celé obrazovky */

  if ( (current_state & GDK_WINDOW_STATE_FULLSCREEN) != 0)

    {

      /* Minimalizuje okno a změní tlačítko na „celá obrazovka“ */

      gdk_window_unfullscreen (window);

      gtk_widget_hide (GTK_WIDGET(leavefullscreen_button));

      gtk_widget_show (GTK_WIDGET(fullscreen_button));

    }

  else

    {

      /* Maximalizuje okno a znění tlačítko na „opustit celou obrazovku“ */

      gdk_window_fullscreen (window);

      gtk_widget_hide (GTK_WIDGET (fullscreen_button));

      gtk_widget_show (GTK_WIDGET (leavefullscreen_button));

    }

}

static void

activate (GtkApplication *app,

          gpointer        user_data)

{

  /* Inicializace proměnných */

  GtkWidget *window;

  GtkWidget *grid;

  GtkWidget *toolbar;

  GtkToolItem *new_button;

  GtkToolItem *open_button;

  GtkToolItem *undo_button;

  GtkStyleContext *style_context;

  GSimpleAction *undo_action;

  GSimpleAction *fullscreen_action;

  GSimpleAction *leavefullscreen_action;

  /* Vytvoří okno s název pro záhlaví a výchozí velikostí */

  window = gtk_application_window_new (app);

  gtk_window_set_title (GTK_WINDOW (window), "Toolbar Example");

  gtk_window_set_default_size (GTK_WINDOW (window), 400, 200);

  /* Zde začínáme vytvářet nástrojovou lištu */

  toolbar = gtk_toolbar_new ();

  /* Nastavíme nástrojovou lištu jako hlavní pro aplikaci */

  style_context = gtk_widget_get_style_context (toolbar);

  gtk_style_context_add_class (style_context, GTK_STYLE_CLASS_PRIMARY_TOOLBAR);

  /* Vytvoříme tlačítko pro akci "new", se standardním obrázkem */

  new_button = gtk_tool_button_new_from_stock (GTK_STOCK_NEW);

  /* Zapne zobrazování popisku tlačítka "new" */

  gtk_tool_item_set_is_important (new_button, TRUE);

  /* Vloží tlačítko na požadovanou pozici na nástrojové liště */

  gtk_toolbar_insert (GTK_TOOLBAR (toolbar), new_button, 0);

  /* Zobrazí tlačítko */

  gtk_widget_show (GTK_WIDGET (new_button));

  /* Nastaví název akce pro akci "new". Použijeme "app.new",

   * aby bylo poznak, že akce ovládá aplikaci

   */

  gtk_actionable_set_action_name (GTK_ACTIONABLE (new_button), "app.new");

  /* Zopakuje stejné kroky pro akci "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");

  /* Zopakuje stejné kroky pro akci "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));

  /* V tomto případě použijeme "win.undo", aby se poznalo, že

   * akce ovládá jen okno

   */

  gtk_actionable_set_action_name (GTK_ACTIONABLE (undo_button), "win.undo");

  /* Zopakuje stejné kroky pro akci "fullscreen" */

  fullscreen_button = gtk_tool_button_new_from_stock (GTK_STOCK_FULLSCREEN);

  gtk_tool_item_set_is_important (fullscreen_button, TRUE);

  gtk_toolbar_insert (GTK_TOOLBAR (toolbar), fullscreen_button, 3);

  gtk_widget_show (GTK_WIDGET (fullscreen_button));

  gtk_actionable_set_action_name (GTK_ACTIONABLE (fullscreen_button),

                                  "win.fullscreen");

  /* Zopakuje stejné kroky pro akci "leavefullscreen" */

  leavefullscreen_button = gtk_tool_button_new_from_stock (GTK_STOCK_LEAVE_FULLSCREEN);

  gtk_tool_item_set_is_important (leavefullscreen_button, TRUE);

  gtk_toolbar_insert (GTK_TOOLBAR (toolbar), leavefullscreen_button, 3);

  /* Jediný rozdíl zde je, že se tlačítko "leavefullscreen" nezobrazí,

   * protože až později nahradí tlačítko "fullscreen".

   */

  gtk_actionable_set_action_name (GTK_ACTIONABLE (leavefullscreen_button),

                                  "win.leavefullscreen");

  /* Jakmile vytvoříme základ nástrojové lišty, ujistíme se,

   * že je ve vodorovném směru dostatek místa

   */

  gtk_widget_set_hexpand (toolbar, TRUE);

  gtk_widget_show (toolbar);

  /* Připojíme nástrojovou lištu do mřížky a tu přidáme do hlavního okna */

  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));

  /* Použijeme názvy akcí k vytvoření akcí, které ovládají okno, a

   * napojíme je na příslušné funkce zpětného volání

   */

  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));

  fullscreen_action = g_simple_action_new ("fullscreen", NULL);

  g_signal_connect (fullscreen_action, "activate", G_CALLBACK (fullscreen_callback),

                    GTK_WINDOW (window));

  g_action_map_add_action (G_ACTION_MAP (window), G_ACTION (fullscreen_action));

  leavefullscreen_action = g_simple_action_new ("leavefullscreen", NULL);

  g_signal_connect (leavefullscreen_action, "activate", G_CALLBACK (fullscreen_callback),

                    GTK_WINDOW (window));

  g_action_map_add_action (G_ACTION_MAP (window), G_ACTION (leavefullscreen_action));

  gtk_widget_show (window);

}

/* Funkce zpětného volání pro akci "new" */

static void

new_callback (GSimpleAction *simple,

              GVariant      *parameter,

              gpointer       user_data)

{

  g_print ("You clicked \"New\".\n");

}

/* Funkce zpětného volání pro akci "open" */

static void

open_callback (GSimpleAction *simple,

               GVariant      *parameter,

               gpointer       user_data)

{

  g_print ("You clicked \"Open\".\n");

}

/* V této funkci vytvoříme akce, které ovládají aplikaci a napojíme

 * jejich signály na příslušnou funkci zpětného volá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));

}

/* Spouštěcí funkce pro aplikaci */

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;

}

V této ukázce se používá následující:

<list>

  <item>
<link href="http://developer.gnome.org/gtk3/stable/GtkToolbar.html">GtkToolbar</link>
</item>

  <item>
<link href="http://developer.gnome.org/gtk3/stable/GtkToolButton.html">GtkToolbutton</link>
</item>

</list>

</page>