<page xmlns="http://projectmallard.org/1.0/" type="topic" id="application-menus" xml:lang="de">

  <info>

    <link type="guide" xref="patterns#primary"/>

    <desc>Globales Anwendungsmenü, das über die obere Leiste erreichbar ist</desc>

    <credit type="author">

      <name>Allan Day</name>

      <email>aday@gnome.org</email>

    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Christian Kirbach</mal:name>

      <mal:email>christian.kirbach@gmail.com</mal:email>

      <mal:years>2014</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Mario Blättermann</mal:name>

      <mal:email>mario.blaettermann@gmail.com</mal:email>

      <mal:years>2016</mal:years>

    </mal:credit>

  </info>

<title>Anwendungsmenüs</title>

<media type="image" mime="image/svg" src="figures/patterns/application-menu.svg"/>

Anwendungsmenüs gewähren Zugriff auf globale Aktionen der obersten Ebene und Optionen Ihrer Anwendung. Diese umfassen Standardeinträge wie die Dokumentation und Informationen zu Ihrer Anwendung.

<section id="when-to-use">

<title>Anwendungsfälle</title>

Anwendungsmenüs sind ein grundlegender Bestandteil von GNOME 3. Jede Anwendung, die unter GNOME 3 läuft, sollte eines haben.

</section>

<section id="general-guidelines">

<title>Allgemeine Richtlinien</title>

<list>

<item>
Folgen Sie dem Standard für <link xref="menus">Menüs</link>.
</item>

<item>
Platzieren Sie dort nur Menüeinträge, die für die Anwendung als Ganzes gelten, wie beispielsweise die Einstellungen. Einträge, die sich nur auf ein bestimmtes Fenster oder eine bestimmte Ansicht beziehen oder auf den Inhalt des Anwendungsfensters angewendet werden, sollten dort nicht zu finden sein.
</item>

<item>
Wenn ein Eintrag eines Anwendungsmenüs häufig genutzt wird, sollten Sie erwägen, diesen an einen besser erreichbaren Ort zu verschieben.
</item>

</list>

</section>

<section id="standard-menu-items">

<title>Standard-Menüeinträge</title>

Häufig verwendete Einträge für Anwendungsmenüs sind <gui>New Window</gui>, <gui>Preferences</gui>, <gui>Help</gui>, <gui>About</gui> und <gui>Quit</gui>. <gui>Help</gui>, <gui>About</gui> und <gui>Quit</gui> sollten in einer eigenen Gruppe zusammengefasst am unteren Ende des Menüs erscheinen.

<gui>New Window</gui>

Öffnet ein neues Fenster. Nur in Anwendungen, die die Ausführung <link xref="primary-windows#application-types">mehrerer Instanzen</link> erlauben, sollte eine solcher Menüeintrag sichtbar sein. Wenn das neue Fenster einen spezifischen Inhaltstyp anzeigt oder eine Aktion simultan ausführt, benennen Sie es um, um es besser unterscheidbar zu machen. Beispiele:<gui>New Connection</gui> oder <gui>New Document</gui>.

<gui>Preferences</gui>

Öffnet den Einstellungsdialog der Anwendung. Verwenden Sie diesen Menüeintrag nur dann, wenn Ihre Anwendung tatsächlich über einen Einstellungsdialog verfügt.

<gui>Help</gui>

Öffnet die Benutzerdokumentation in der Anwendung <app>Help</app>. Verwenden Sie diesen Menüeintrag nur dann, wenn Ihre Anwendung tatsächlich über einen Benutzerdokumentation verfügt.

<gui>About</gui>

Öffnet den Informationsdialog der Anwendung, den es in jeder Anwendung geben sollte.

<gui>Quit</gui>

Schließt die Anwendung und alle geöffneten Fenster. Dieser Eintrag sollte in jedem Anwendungsmenü zu finden sein.

</section>

<section id="api-reference">

<title>API-Referenz</title>

<list>

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

</list>

</section>

</page>