<gui>Hilfe</gui> dem Anwendungsmenü hinzufügen

Radina Matic radina.matic@gmail.com 2013 Ekaterina Gerasimova kittykat3756@gmail.com 2013 Mario Blättermann mario.blaettermann@gmail.com 2009-2012, 2016 Christian Kirbach christian.kirbach@gmail.com 2011, 2012, 2015, 2017, 2018 Aljosha Papsch al@rpapsch.de 2012 <gui>Hilfe</gui> dem Anwendungsmenü hinzufügen Hilfe einrichten

Die meisten GNOME-Anwendungen sollten über ein Anwendungsmenü verfügen. Der Help-Menüeintrag sollte dabei oberhalb des About-Eintrags angezeigt werden.

Dieses auf Cheese basierende Beispiel setzt voraus, dass Ihre Anwendung in Vala geschrieben ist. Es wird für andere Programmiersprachen etwas abweichen.

Fügen Sie den Eintrag Hilfe der Aktionsliste hinzu:


   private const GLib.ActionEntry action_entries[] = {
        { "help", on_help },
        { "about", on_about },
        { "quit", on_quit }
    };

   add_action_entries (action_entries, my_Gtk_Application);

Fügen Sie den Menüeintrag Hilfe dem Anwendungsmenü hinzu:


  var menu = new GLib.Menu ();
  var section = new GLib.Menu ();

  var item = new GLib.MenuItem (_("_Help"), "app.help");
  item.set_attribute ("accel", "s", "F1");
  section.append_item (item);

Zeigen Sie die Hilfe mit Yelp an, wenn der Menüeintrag Help angeklickt wird:


  private void on_help ()
  {
    var screen = main_window.get_screen ();
    try
    {
      Gtk.show_uri (screen, "help:cheese", Gtk.get_current_event_time ());
    }
    catch (Error err)
    {
      message ("Error opening help: %s", err.message);
    }
  }

Um zu einem Abschnitt in index.page zu verweisen, verwenden Sie "help:Anwendungsname/index#Abschnittskennung".