<?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="pt-BR">

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Menus comuns mostrados no lado direito de uma barra de cabeçalho</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>Georges Neto</mal:name>
      <mal:email>georges.stavracas@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>Rafael Fontenelle</mal:name>
      <mal:email>rafaelff@gnome.org</mal:email>
      <mal:years>2017</mal:years>
    </mal:credit>
  </info>

<title>Menus de barra de cabeçalhos</title>

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

<p>As <link xref="header-bars">barras de cabeçalho</link> podem incluir um menu que contém ações e opções para a visualização atual. Esses menus estão localizados no lado direito da barra de cabeçalho.</p>

<p>Enquanto as ações frequentemente utilizadas para uma visualização devem ser colocadas diretamente na barra de cabeçalho, um menu de barra de cabeçalho fornece acesso a ações menos usadas. Isso garante que a barra de cabeçalho não esteja sobrecarregada com controles menos interessantes ou úteis.</p>

<p>Desta forma, os menus da barra de cabeçalho ajudam a criar visões focalizadas que orientam o usuário para a funcionalidade mais interessante e útil.</p>

<section id="when-to-use">
<title>Quando usar</title>

<p>Use um menu de barra de cabeçalho para apresentar ações ou opções adicionais para a visão atual. Eles são melhor usados quando essas ações ou opções não são usadas a maior parte do tempo – se houver um conjunto de ações que merecem maior destaque na visão, uma <link xref="action-bars">barra de ação</link> pode ser uma escolha melhor.</p>

<p>Os menus da barra de cabeçalho não são uma boa opção para executar ações no conteúdo selecionado: quando o conteúdo não foi selecionado, o menu conterá elementos de menu insensíveis e inúmeros, e quando o conteúdo tiver sido selecionado, as ações possíveis não serão anunciadas. <link xref="selection-mode">Modo de seleção</link> ou <link xref="popovers">janelas sobrepostas</link> são uma escolha melhor para esta situação.</p>

</section>

<section id="guidance">
<title>Orientação</title>

<list>
<item><p>Os menus da barra de cabeçalho só devem conter ações para a visualização ou janela atual – isso diferencia seu conteúdo dos menus da aplicação.</p></item>
<item><p>Siga as <link xref="menus">diretrizes padrão para menus</link>.</p></item>
<item><p>Um menu de barra de cabeçalho está contido dentro de uma <link xref="popovers">janela sobreposta</link>. Como tal, um menu de barra de cabeçalho pode incluir uma variedade de controles, como grupos de botões.</p></item>
<item><p>Os menus da barra de cabeçalho não devem incluir um item de menu próximo, uma vez que esta ação já foi fornecida pela barra de cabeçalho. Também pode ser ambíguo em relação a qual item de menu para fechamento se refere.</p></item>
</list>

</section>

<section id="api-reference">
<title>Referência de API</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>