Управление окнами

To create the engine window viewport, one of the EngineWindowViewport class constructors is used.Для создания окна просмотра движка используется один из конструкторов класса EngineWindowViewport.

// create an engine window of the specified size with the specified name
EngineWindowViewportPtr window = EngineWindowViewport::create("New window", 580, 300);

When the window viewport is created, you can change its settings: specify the engine tools available, set the viewport as the main one, specify the camera the image from which is rendered into the viewport, and so on. All these operations are provided by the EngineWindowViewport class. For example:Когда окно просмотра создано, вы можете изменить его настройки: указать доступные инструменты движка, установить окно просмотра в качестве основного, указать камеру, изображение с которой выводится в окно просмотра, и так далее. Все эти операции предоставляются классом EngineWindowViewport. Например:

// set the window viewport as the main one
window->setMain(true);

// enable the console, profiler and visualizer for the window viewport
window->setConsoleUsage(true);
window->setProfilerUsage(true);
window->setVisualizerUsage(true);

You can also add widgets to the client area of the window:Вы также можете добавить виджеты в клиентскую область окна:

// add widgets to the client area
window->addChild(WidgetLabel::create(window->getSelfGui(), String::format("This is %s window.", window->getTitle())));
window->addChild(WidgetButton::create(window->getSelfGui(), window->getTitle()), Gui::ALIGN_CENTER);

Примечание

The window viewport is considered a separate engine window until it is added to a group.Окно просмотра считается отдельным окном движка до тех пор, пока оно не будет добавлено в группу.

To control window components, its behaviour, visual representaion, and style, use the EngineWindow class functionality. The corresponding article contains short samples that cover most of the available functions.Чтобы управлять компонентами окна, его поведением, визуальным представлением и стилем, используйте функциональность класса EngineWindow. Соответствующая статья содержит краткие примеры, которые охватывают большинство доступных функций.

Also UNIGINE SDK provides a set of samples (source/samples/Api/WindowManager) that allow you to try all settings in action. For example, in the WindowSandbox sample, you can create a window viewport and adjust it.Также UNIGINE SDK предоставляет набор примеров (source/samples/Api/WindowManager), которые позволяют вам попробовать все настройки в действии. Например, в примере WindowSandbox вы можете создать окно просмотра и настроить его.

While the application is running, you can group and ungroup the existing windows by using the mouse.Пока приложение запущено, вы можете группировать и разгруппировывать существующие окна с помощью мыши.

To group two separate windows, do the following:Чтобы сгруппировать два отдельных окна, выполните следующие действия:

1. Hold the mouse button while moving the window to the destination one. The destination window will be divided into 9 sectors.Удерживая нажатой кнопку мыши, перемещайте окно в нужное место. Окно назначения будет разделено на 9 секторов.
2. Choose the required sector and release the mouse button — the windows will be grouped.Выберите нужный сектор и отпустите кнопку мыши — окна будут сгруппированы.

To add the window to the existing group, you should hold the mouse button while moving the window and release it in one of the following areas:Чтобы добавить окно в существующую группу, вам следует удерживать кнопку мыши при перемещении окна и отпустить ее в одной из следующих областей:

• For the horizontal group:Для горизонтальной группы:

  

• For the vertical group:Для вертикальной группы:

  

• For the group of tabs:Для группы вкладок:

  

To ungroup the window, move it outside the group by dragging the title bar.Чтобы разгруппировать окно, переместите его за пределы группы, перетащив строку заголовка.

The engine window can be accessed via the getWindow() function of the WindowManager class.Доступ к окну движка можно получить с помощью функции getWindow() класса WindowManager.

// get the number of windows
int num = WindowManager::getNumWindows();
// check each window
for (int i = 0; i < num; i++)
{
	// get the window with the current index
	EngineWindowPtr window = WindowManager::getWindow(i);
	// change its position and size if it is main
	if (window == WindowManager::getMainWindow())
	{
		window->setPosition(Math::ivec2(1020, 60));
		window->setSize(Math::ivec2(305, 670));
	}
}

There are also some functions (like getMainWindow()) that allow accessing the specific windows (the main, focused, fullscreen window and so on). For example:Существуют также некоторые функции (например, getMainWindow()), которые позволяют получать доступ к определенным окнам (основное окно, окно в фокусе, полноэкранное окно и так далее). Например:

// get the main window
EngineWindowPtr main_window = WindowManager::getMainWindow();
// change its position and size
if (main_window)
{
	main_window->setPosition(Math::ivec2(1020, 60));
	main_window->setSize(Math::ivec2(305, 670));
}

In the WindowManager class, there are two main functions for grouping windows:В классе WindowManager есть две основные функции для группировки окон:

• WindowManager::stack() creates a group of two windows.WindowManager::stack() создает группу из двух окон.
• WindowManager::stackGroups() creates a group of two window groups.WindowManager::stackGroups() создает группу из двух групп окон.

// create separate windows
EngineWindowViewportPtr horizontal_1 = EngineWindowViewport::create("Horizontal 1", 512, 256);
EngineWindowViewportPtr horizontal_2 = EngineWindowViewport::create("Horizontal 2", 512, 256);
EngineWindowViewportPtr horizontal_3 = EngineWindowViewport::create("Horizontal 3", 512, 256);
EngineWindowViewportPtr horizontal_4 = EngineWindowViewport::create("Horizontal 4", 512, 256);

// create 2 horizontal window groups 
EngineWindowGroupPtr horizontal_group_1 = WindowManager::stack(horizontal_1, horizontal_2, EngineWindowGroup::GROUP_TYPE_HORIZONTAL);
EngineWindowGroupPtr horizontal_group_2 = WindowManager::stack(horizontal_3, horizontal_4, EngineWindowGroup::GROUP_TYPE_HORIZONTAL);
// create a vertical group of 2 horizontal groups
EngineWindowGroupPtr vertical_group = WindowManager::stackGroups(horizontal_group_1, horizontal_group_2, EngineWindowGroup::GROUP_TYPE_VERTICAL);
// specify position, size, title of the verical window group
vertical_group->setPosition(Math::ivec2(50, 60));
vertical_group->setSize(Math::ivec2(565, 310));
vertical_group->setTitle("Vertical Group");
// render the window group
vertical_group->show();

Each window or window group has a state, so it changes after stacking.Каждое окно или группа окон имеет состояние, поэтому оно изменяется после стыковки.

There are also functions based on the stack() function that should be used in specific cases to avoid additional checking of arguments:Существуют также функции, основанные на функции stack(), которые следует использовать в конкретных случаях, чтобы избежать дополнительной проверки аргументов:

• WindowManager::stackToParentGroup() stacks the second window to the parent group of the first window. In the result, both windows passed as arguments will be on the same level in the group hierarchy.WindowManager::stackToParentGroup() помещает второе окно в родительскую группу первого окна. В результате оба окна, переданные в качестве аргументов, будут находиться на одном уровне в иерархии групп.

  Исходный код (C++)

  // create separate windows
  EngineWindowViewportPtr window_1 = EngineWindowViewport::create("Window 1", 512, 256);
  EngineWindowViewportPtr window_2 = EngineWindowViewport::create("Window 2", 512, 256);
  EngineWindowViewportPtr window_3 = EngineWindowViewport::create("Window 3", 512, 256);
  
  // stack 2 separate windows
  EngineWindowGroupPtr group_0 = WindowManager::stackWindows(window_1, window_2, EngineWindowGroup::GROUP_TYPE_HORIZONTAL);
  // stack a separate window to the parent group of "window_1"
  WindowManager::stackToParentGroup(window_1, window_3);

  

• WindowManager::stackWithWindow() stacks the window to the other window. If the first argument is the separate window, a new window group is returned. If the first argument is the nested window, the window is added to its group.WindowManager::stackWithWindow() стыкует одно окно с другим. Если первым аргументом является отдельное окно, возвращается новая группа окон. Если первым аргументом является вложенное окно, то окно добавляется в эту группу.

  Исходный код (C++)

  // create a group of 2 windows
  EngineWindowGroupPtr group_1 = WindowManager::stack(window_1, window_2, EngineWindowGroup::GROUP_TYPE_HORIZONTAL);
  // stack a separate window to the window from the window group
  WindowManager::stackWithWindow(window_1, window_3, EngineWindowGroup::GROUP_TYPE_VERTICAL);

  

• WindowManager::stackWindows() creates a group of the separate/nested windows. The windows are stacked in the default order.WindowManager::stackWindows() создает группу отдельных/вложенных окон. Окна расположены в порядке, установленном по умолчанию.
• WindowManager::stackToGroup() stacks the window or window group to another window group.WindowManager::stackToGroup() помещает окно или группу окон в другую группу окон.

For ungrouping, the WindowManager::unstack() function is used: it removes the window or the window group from the parent group. If only one window remains in the group, it is automatically removed from the group and the group is deleted.Для разгруппировки используется функция WindowManager::unstack(): она удаляет окно или группу окон из родительской группы. Если в группе остается только одно окно, оно автоматически удаляется из группы, а сама группа удаляется.