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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Common menus shown on the right side of a header bar</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>Kopfleistenmenüs</title>

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

<p><link xref="header-bars">Kopfleisten</link> können ein Menü enthalten, welches Aktionen und Optionen für die aktuelle Ansicht enthält. Diese Menüs befinden sich an der äußersten rechten Seite der Kopfleiste.</p>

<p>While the most frequently used actions for a view should be placed directly in the header bar, a header bar menu provides access to lesser-used actions. This ensures that the header bar isn’t overwhelmed with less interesting or useful controls.</p>

<p>In this way, the header bar menus help to create focused views that guide the user towards the most interesting and useful functionality.</p>

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

<p>Use a header bar menu to present additional actions or options for the current view. They are best used when those actions or options are not used the majority of the time - if there is a set of actions which deserve more prominence in the view, an <link xref="action-bars">action bar</link> might be a better choice.</p>

<p>Header bar menus are not a good choice for performing actions on selected content: when content hasn’t been selected, the menu will contain unhelpful insensitive menu items, and when content has been selected, possible actions will not be advertised. <link xref="selection-mode">Selection mode</link> or <link xref="popovers">popovers</link> are a better choice for this situation.</p>

</section>

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

<list>
<item><p>Kopfleistenmenüs sollten nur Aktionen enthalten, die in der aktuellen Ansicht oder Fenster relevant sind – das unterscheidet sie von Anwendungsmenüs.</p></item>
<item><p>Folgen Sie den <link xref="menus">Standard-Richtlinien für Menüs</link>.</p></item>
<item><p>A header bar menu is contained within a <link xref="popovers">popover</link>. As such, a header bar menu can include a variety of controls, such as groups of buttons.</p></item>
<item><p>Kopfleistenmenüs sollten keinen Schließen-Eintrag enthalten, da diese Aktion bereits in der Kopfleiste selbst verfügbar ist. Es kann auch zweideutig sein, was ein Schließen-Eintrag bewirkt.</p></item>
</list>

</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>
