<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:uix="http://projectmallard.org/experimental/ui/" type="topic" id="primary-menus" xml:lang="de">

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Das Hauptmenü der Anwendung, durch drei übereinander liegende horizontale Linien angedeutet</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>Primäre Menüs</title>

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

<p>Primäre Menüs sind ein Standard-Designmuster, das in den meisten Anwendungen zu finden ist. Sie sind mit dem Menü-Symbol beschriftet (namens <code>menu-open</code>) und enthalten das Menü der obersten Ebene der Anwendung. Dieses kann Standardeinträge wie <gui>Preferences</gui>, <gui>Help</gui> und <gui>About Application</gui> sowie weitere anwendungsspezifische Einträge enthalten.</p>


<section id="when-to-use">
<title>Anwendungsfälle</title>

<p>Die meisten Anwendungen haben primäre Menüs, da diese der Standardort für <gui>About Application</gui> sind, was jede Anwendung haben sollte.</p>

</section>

<section id="guidance">
<title>Richtlinien</title>

<p>Primäre Menüs werden typischerweise am rechten Ende der Kopfleiste platziert. Jedoch gibt es eine Reihe von Abweichungen von dieser Regel:</p>

<list>
<item><p>Wenn die Anwendung Navigation im Fenster mit einem Ort der obersten Ebene und dazugehörigen Unterseiten ermöglicht, sollte das primäre Menü nur in der obersten Ebene platziert werden: Unterseiten können ein <link xref="secondary-menus">sekundäres Menü</link> enthalten, sofern ein Menü erforderlich ist.</p></item>
<item><p>Wenn ein primäres Menü mit einer <link xref="sidebar-lists">Seitenleistenliste</link> kombiniert wird, sollte es oberhalb der rechten Seitenleistenliste platziert werden. Wenn für die im Inhaltsbereich des Fensters angezeigten Elemente ein Menü notwendig ist, können Sie dafür ein <link xref="secondary-menus">sekundäres Menü</link> verwenden.</p></item>
</list>

<p>Weitere Richtlinien:</p>

<list>
<item><p>Primäre Menüs können Einträge für sowohl das aktuelle Fenster oder die aktuelle Ansicht, aber auch für die Anwendung als Ganzes enthalten. Dies unterscheidet sie von <link xref="secondary-menus">sekundären Menüs</link>, welche nur Menüeinträge enthalten, die sich auf eine spezifische Ansicht oder ein spezifisches Objekt beziehen.</p></item>
<item><p>Folgen Sie den <link xref="menus">Standard-Richtlinien für Menüs</link>, wenn Sie den Inhalt des primären Menüs und die anordung innerhalb dessen festlegen.</p></item>
<item><p>Ein primäres Menü ist von einem <link xref="popovers">Einblendmenü</link> umschlossen. Als solches kann ein primäres Menü verschiedene Bedienelemente enthalten, wie beispielsweise Knopfgruppen.</p></item>
</list>

</section>

<section id="standard-menu-items">
<title>Standard-Menüeinträge</title>

<p>Die folgenden Einträge gelten als Standards für ein primäres Menü und sollten an dessen Ende platziert werden:</p>

<table>
<tr>
<td><p><gui>Preferences</gui></p></td>
<td><p>Öffnet den Einstellungsdialog der Anwendung, sofern verfügbar.</p></td>
</tr>
<tr>
<td><p><gui>Keyboard Shortcuts</gui></p></td>
<td><p>Öffnet das Fenster mit den Tastenkombinationen der Anwendung, sofern verfügbar.</p></td>
</tr>
<tr>
<td><p><gui>Help</gui></p></td>
<td><p>Öffnet die Benutzerdokumentation in der Anwendung <app>Help</app>.</p></td>
</tr>
<tr>
<td><p><gui>About Application</gui></p></td>
<td><p>Öffnet den Infodialog zur Anwendung. Hier sollte der Anwendungsname enthalten sein, wie beispielsweise <gui>About Photos</gui> oder <gui>About Calculator</gui>. Jedes primäre Menü sollte einen solchen Eintrag enthalten.</p></td>
</tr>
</table>

<p>Primäre Menüs sollten keinen Schließen-Eintrag enthalten, der die Anwendung beendet, da Fenster bereits in der Kopfleiste selbst geschlossen werden können und es zweideutig sein kann, was ein Schließen-Eintrag bewirkt. Benutzer unterscheiden letztendlich nicht zwischen Beenden und Schließen und können so in die Irre geführt werden.</p>

</section>

<section id="api-reference">
<title>API-Referenz</title>

<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkMenuButton.html">GtkMenuButton</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkPopoverMenu.html">GtkPopoverMenu</link></p></item>
</list>

</section>

</page>
