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

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>O menu secundário do aplicativo, representado por três pontos horizontais empilhadas</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-2021</mal:years>
    </mal:credit>
  </info>

<title>Menus secundários</title>

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

<p>Os menus secundários estão localizados na barra de cabeçalho e incluem itens de menu para a exibição atual ou o item de conteúdo. Isso os diferencia de <link xref="primary-menus">menus primários</link>, que incluem itens de menu relacionados a um aplicativo inteiro (como <gui>Preferences</gui> e <gui>About “Name”</gui>).</p>

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

<p>Os menus secundários podem ser usados para hospedar controles relacionados a um determinado item de conteúdo que está sendo exibido na janela do aplicativo (como um documento, contato, conversa ou foto). Eles são normalmente usados em combinação com navegação na janela ou <link xref="sidebar-lists">listas da barra lateral</link>, já que ambos os arranjos apresentam visualizações ou áreas separadas para itens de conteúdo a serem mostrados.</p>

<p>Os menus secundários são opcionais e só precisam ser usados se houver controles suficientes para exigir um menu.</p>

</section>

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

<list>
<item><p>Menus secundários geralmente não devem reproduzir itens de menu incluídos nos <link xref="primary-menus">menus primários</link>, como <gui>Preferences</gui> e <gui>About</gui>. No entanto, às vezes pode ser útil mostrar <gui>Help</gui>.</p></item>
<item><p>As <link xref="menus">diretrizes padrão para menus</link> podem ser seguidas ao projetar os menus secundários.</p></item>
<item><p>Um menu secundário 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>Menus secundários não devem incluir itens de menu para fechar ou abrir.</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>
