<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="application-menus" xml:lang="ru">

  <info>
    <link type="guide" xref="patterns#primary"/>
    <desc>Global application menu that is accessed from the top 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"/>
  </info>

<title>Меню приложения</title>

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

<p>Меню приложения предоставляет доступ к важнейшим действиям и параметрам вашего приложения. Оно также включает в себя стандартные элементы для получения доступа к документации и информации о приложении.</p>

<section id="when-to-use">
<title>Когда использовать</title>

<p>Меню приложения является стандартным элементом GNOME 3, любое запускаемое под GNOME 3 приложение должно иметь меню.</p>

</section>

<section id="general-guidelines">
<title>Общие рекомендации</title>

<list>
<item><p>Следуйте стандартным <link xref="menus">рекомендациям для меню</link>.</p></item>
<item><p>Добавляйте только те элементы, которые относятся к приложению в целом, например параметры приложения. Не добавляйте элементы, которые относятся к текущему окну или документу или действуют на содержимое внутри окна приложения.</p></item>
<item><p>Рассмотрите возможность перемещения наиболее часто используемых элементов меню в более доступное место.</p></item>
</list>

</section>

<section id="standard-menu-items">
<title>Стандартные элементы меню</title>

<p>Стандартные элементы меню включают в себя следующие элементы: <gui>Создать окно</gui>, <gui>Параметры</gui>, <gui>Справка</gui>, <gui>О приложении</gui> и <gui>Завершить</gui>. Элементы <gui>Справка</gui>, <gui>О приложении</gui> и <gui>Завершить</gui> должны помещаться в рамках собственной группы в нижней части меню.</p>

<table>
<tr>
<td><p><gui>Создать окно</gui></p></td>
<td><p>Открывает новое окно. Этот элемент необходимо включать только в тех приложениях, в которых поддерживается <link xref="primary-windows#application-types">несколько экземпляров содержимого</link>. Если в новом окне находится содержимое определённого типа или одновременно выполняется некоторое действие, переименуйте его. Например: <gui>Создать подключение</gui> или <gui>Создать документ</gui>.</p></td>
</tr>
<tr>
<td><p><gui>Параметры</gui></p></td>
<td><p>Открывает диалог с параметрами приложения. Добавляйте этот элемент только только в том случае, если у вашего приложения есть диалог параметров.</p></td>
</tr>
<tr>
<td><p><gui>Справка</gui></p></td>
<td><p>Открывает документацию пользователя по вашему приложению с помощью стандартного средства просмотра <app>Справки</app>. Добавляйте этот элемент только в том случае, если у вашего приложения есть документация.</p></td>
</tr>
<tr>
<td><p><gui>О приложении</gui></p></td>
<td><p>Открывает стандартный диалог с информацией о вашем приложении. Этот элемент должен присутствовать во всех приложениях, в которых есть меню.</p></td>
</tr>
<tr>
<td><p><gui>Завершить</gui></p></td>
<td><p>Закрывает приложения вместе со всеми его окнами. Этот элемент должен присутствовать во всех приложениях, в которых есть меню.</p></td>
</tr>
</table>

</section>

<section id="api-reference">
<title>API reference</title>
<list>
<item><p><link href="https://developer.gnome.org/gtk3/stable/GtkApplication.html">GtkApplication</link></p></item>
</list>
</section>
</page>
