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

  <info>
    <credit type="author">
      <name>Allan Day</name>
      <email>aday@gnome.org</email>
    </credit>
    <credit>
      <name>Calum Benson</name>
    </credit>
    <credit>
      <name>Adam Elman</name>
    </credit>
    <credit>
      <name>Seth Nickell</name>
    </credit>
    <credit>
      <name>Colin Robertson</name>
    </credit>

    <link type="guide" xref="ui-elements"/>
    <uix:thumb mime="image/svg" src="figures/ui-elements/menu-bar.svg"/>

    <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>Barras de menu</title>

<p>Uma barra de menu incorpora uma tira de menus suspensos. Ela geralmente está localizada no topo de uma janela primária, abaixo de uma barra de título da janela.</p>

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

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

<p>As barras de menus aumentam a pegada vertical da interface de usuário de um aplicativo, apresentam um grande número de pontos de divulgação e funcionam como um conjunto fixo de opções inflexíveis. Por estas razões, <link xref="header-bars">barras de cabeçalho</link> e <link xref="header-bar-menus">menus da barra de cabeçalho</link> geralmente são recomendados nas barras de menu, juntamente com outros padrões de design para expor controles sob demanda, como <link xref="selection-mode">modo de seleção</link>, <link xref="action-bars">barras de ação</link> e <link xref="popovers">janelas sobrepostas</link>.</p>

<p>Ao mesmo tempo, pode ser apropriado para aplicativos complexos que já incluem uma barra de menu para mantê-lo. Além disso, algumas plataformas também incorporam espaço para uma barra de menu em seu ambiente de usuário, e um modelo de menu pode ser desejável para fins de integração entre plataformas.</p>

</section>

<section id="standard-menus">
<title>Menus padrão</title>

<p>Esta seção detalha os menus e itens de menu mais comuns em uma barra de menu. Para obter detalhes sobre os itens padrão a serem incluídos em cada um desses menus, consulte <link xref="keyboard-input#application-shortcuts">entrada do teclado</link>.</p>

<table>
<tr>
<td><p><gui>File</gui></p></td>
<td><p>Comandos que operam no documento atual ou item de conteúdo como um todo. É o item mais à esquerda no menu devido à sua importância e frequência de uso, e porque é um menu relevante em muitos aplicativos.</p>
<p>Se o seu aplicativo não funcionar em arquivos, nomeie este menu para o tipo de objeto que ele exibe. Por exemplo, um reprodutor de música pode ter um <gui>Music</gui> em vez de um menu <gui>File</gui>.</p></td>
</tr>
<tr>
<td><p><gui>Edit</gui></p></td>
<td><p>O menu <gui>Edit</gui> contém itens relacionados à edição do documento, como manipulação de área de transferência, localizar e substituir e inserir objetos.</p></td>
</tr>
<tr>
<td><p><gui>View</gui></p></td>
<td><p>Inclui itens que afetam a visão do usuário, como no documento ou página atual, ou como os itens são apresentados para navegação. Não coloque itens no menu <gui>View</gui> que afetem os itens de conteúdo.</p></td>
</tr>
<tr>
<td><p><gui>Insert</gui></p></td>
<td><p>Lista os tipos de objetos que podem ser inseridos no documento atual, como imagens, links ou quebras de página. Apenas forneça este menu se você tiver mais de seis tipos de objetos que podem ser inseridos, caso contrário, coloque itens individuais para cada tipo no menu <gui>Edit</gui>.</p></td>
</tr>
<tr>
<td><p><gui>Format</gui></p></td>
<td><p>Inclui comandos para alterar a aparência visual do documento. Por exemplo, alterar a fonte, a cor ou o espaçamento entre linhas de uma seleção de texto.</p>
<p>A diferença entre esses comandos e aqueles no menu <gui>View</gui> é que as alterações feitas com os comandos de <gui>Format</gui> são persistentes e salvas como parte do documento.</p>
<p>Os itens localizados no menu Format são muito específicos do aplicativo.</p></td>
</tr>
<tr>
<td><p><gui>Bookmarks</gui></p></td>
<td><p>Forneça um menu Bookmarks em qualquer aplicativo que permita ao usuário navegar arquivos e pastas, documentos de ajuda, páginas da web ou qualquer outro espaço de informação grande.</p></td>
</tr>
<tr>
<td><p><gui>Go</gui></p></td>
<td><p>Um menu <gui>Go</gui> fornece comandos para navegar rapidamente por um documento ou coleção de documentos, ou um espaço de informações, como uma estrutura de diretório ou a web.</p>
<p>O conteúdo do menu variará dependendo do tipo de aplicativo.</p></td>
</tr>
<tr>
<td><p><gui>Windows</gui></p></td>
<td><p>Comandos que se aplicam a todas as janelas abertas do aplicativo. Você também pode rotular este menu de <gui>Documents</gui>, <gui>Buffers</gui> ou similar de acordo com o tipo de documento tratado pelo seu aplicativo.</p>
<p>Os últimos itens neste menu são uma lista numerada das janelas principais do aplicativo, por exemplo <gui>1listacompras.abw</gui>. Selecionar um desses itens aumenta a janela correspondente.</p></td>
</tr>
</table>

</section>

<section id="general-guidelines">
<title>Diretrizes gerais</title>

<list>
<item><p>A barra de menu está normalmente visível em todos os momentos e é sempre acessível a partir do teclado, para que todos os comandos disponíveis em sua aplicação estejam disponíveis no menu. (Esta orientação é exclusiva das barras de menu – outros menus não devem procurar reproduzir a funcionalidade disponibilizada por outros controles).</p></item>
<item><p>Trate <link xref="application-menus">menus de aplicativo</link> como parte da barra de menus – não é necessário reproduzir itens do menu do aplicativo em outros menus.</p></item>
<item><p>Não desabilite os títulos dos menus. Permita que o usuário explore o menu, mesmo que não haja itens disponíveis nesse momento.</p></item>
<item><p>Os títulos dos menus em uma barra de menu são palavras simples com a letra inicial em maiúscula. Não use espaços em títulos de menu, pois isso os confunde facilmente com dois títulos de menu separados. Não use palavras compostas (como <gui>OpçõesJanelas</gui>) ou hífenes (como <gui>Opções-Janelas</gui>) para contornar esta diretriz.</p></item>
<item><p>Não forneça um mecanismo para ocultar a barra de menu, pois isso pode ser ativado acidentalmente. Alguns usuários poderão não descobrir como recuperar a barra de menu neste caso.</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/GtkMenu.html">GtkMenu</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkMenuBar.html">GtkMenuBar</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkMenuItem.html">GtkMenuItem</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkRadioMenuItem.html">GtkRadioMenuItem</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkCheckMenuItem.html">GtkCheckMenuItem</link></p></item>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkSeparatorMenuItem.html">GtkSeparatorMenuItem</link></p></item>
</list>
</section>

</page>
