<page xmlns="http://projectmallard.org/1.0/" type="topic" id="primary-windows" xml:lang="ru">

  <info>

    <link type="guide" xref="patterns#primary"/>

    <desc>The main window(s) for your application</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/primary-windows.svg"/>

Главные окна -- это основной высокоуровневый контейнер для пользовательского интерфейса вашего приложения, который должен предоставлять основную функциональность приложения.

<section id="when-to-use">

<title>Когда использовать</title>

Любое приложение должно иметь по крайней мере одно главное окно, связанное с приложением.

</section>

<section id="application-types">

<title>Типы приложений</title>

Существует две основные модели главных окон:

<section id="single-instance-applications">

<title>Одноэкземплярные приложения</title>

Одноэкзамплярные приложения имеют одно главное окно. Эта модель широко применяется для таких приложений как: клиенты для эл. почты, чаты, адресные книги, клиенты обмена мгновенными сообщениями.

</section>

<section id="multiple-instance-applications">

<title>Мультэкземплярные приложения</title>

Мультэкземплярные приложения могут иметь несколько главных окон. Обычно все главные окна идентичны друг другу. Эта модель часто применяется в приложениях для просмотра или в редакторах (документов, изображений и т. п.).

Обе модели позволяют открывать. Через <link xref="tabs">вкладки</link> или перемещение в браузерном стиле. Однако мультиоконная модель предоставляет дополнительные возможности:

<list>

<item>
одновременный просмотр содержимого нескольких элементов;
</item>

<item>
возможность перемещать содержимое на другие рабочие места;
</item>

<item>
возможность распологать наборы с содержимым в различных окнах (если применяются вкладки).
</item>

</list>

<section id="parent-child-primary-windows">

<title>Parent/child primary windows</title>

Multiple instance applications typically have identical primary windows (in the case multiple web browser windows, for example). However, this is not always the case.

Primary windows can have a parent/child relationship. In this type of application, there is only ever one parent window. This typically contains an overview of content items which can be opened in the parent window, or in a separate child window. This allows multiple content items to be simultaneously open.

While child windows can only be opened through a parent window, they are not dependent on them in order to stay open: closing the parent window does not result in the closure of the application's child windows.

GNOME's <app>Notes</app> application is a good example of parent/child primary windows.

</section>

</section>

</section>

<section id="general-guidelines">

<title>Общие рекомендации</title>

<list>

<item>
A single primary window should always be displayed when your application is launched.
</item>

<item>
If your application launcher is activated while your application is running, all its primary windows should be displayed.
</item>

<item>
Основная функциональность вашего приложения должна реализовываться через главные окна. Не используйте диалоговые или иные второстепенные окна для основной функциональности.
</item>

<item>
Главные окна должны быть независимыми: закрытие одного главного окна не должно заставлять закрываться другие главные окна.
</item>

<item>
Диалоговые окна должны всегда зависеть от главного окна. Подробнее см. <link xref="dialogs">диалоги</link>.
</item>

<item>
The guidelines on <link xref="display-compatibility">display compatibility</link> are particularly relevant for primary windows: be careful to ensure that they follow the advice on minimum display sizes, display orientation, and half-screen snap.
</item>

<item>
Действие <gui>Завершить</gui> должно закрывать все главные окна.
</item>

</list>

</section>

<section id="api-reference">

<title>API reference</title>

<list>

<item>
<link href="https://developer.gnome.org/gtk3/stable/GtkWindow.html">GtkWindow</link>
</item>

<item>
<link href="https://developer.gnome.org/gtk3/stable/GtkApplicationWindow.html">GtkApplicationWindow</link>
</item>

</list>

</section>

</page>