Язык

AppWindow Класс

Определение

Представляет управляемый системой контейнер для содержимого приложения.

public ref class AppWindow sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppWindow final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppWindow
Public NotInheritable Class AppWindow
Наследование
Object Platform::Object IInspectable AppWindow
Атрибуты

Комментарии

Important

API настройки строки заголовков частично поддерживаются в Windows 10, так как Windows App SDK 1.2 и полностью поддерживаются в Windows 11. Перед вызовом этих API необходимо проверить AppWindowTitleBar.IsCustomizationSupported в коде, чтобы убедиться, что приложение не завершает работу с другими версиями Windows. Дополнительные сведения см. в разделе "Настройка строки заголовка ".

Свойства

Имя Описание
ClientSize

Возвращает текущий размер клиентской области окна в координатах клиента Win32.

DispatcherQueue

Возвращает очередь диспетчера, связанную с окном приложения.

Id

Возвращает идентификатор окна приложения.

IsShownInSwitchers

Возвращает или задает значение, указывающее, будет ли это окно отображаться в различных системных представлениях, таких как ALT+TAB и панель задач.

IsVisible

Возвращает значение, указывающее, отображается ли окно.

OwnerWindowId

Возвращает идентификатор владельца этого окна; или 0, если он не принадлежит.

PersistedStateId

Представляет управляемый системой контейнер для содержимого приложения.

PlacementRestorationBehavior

Представляет управляемый системой контейнер для содержимого приложения.

Position

Возвращает текущую позицию окна в координатах экрана.

Presenter

Возвращает текущего примененного докладчика для окна приложения.

Size

Возвращает текущий размер окна в координатах экрана.

Title

Возвращает или задает отображаемое название окна приложения.

TitleBar

Возвращает заголовок окна приложения.

Методы

Имя Описание
AssociateWithDispatcherQueue(DispatcherQueue)

Связывает окно приложения с указанной очередью диспетчера.

Create()

Создает окно приложения со стилями и свойствами, заданными по умолчанию OverlappedPresenter.

Create(AppWindowPresenter, WindowId, DispatcherQueue)

Создает окно со стилями и свойствами, определенными в указанном AppWindowPresenter, родительском для указанного окна и связанном с указанным DispatcherQueue.

Create(AppWindowPresenter, WindowId)

Создает окно со стилями и свойствами, определенными в указанном AppWindowPresenter и родительском окне.

Create(AppWindowPresenter)

Создает окно со стилями и свойствами, определенными в указанном AppWindowPresenter.

Destroy()

Пытается уничтожить окно приложения.

GetCurrentPlacement()

Представляет управляемый системой контейнер для содержимого приложения.

GetFromWindowId(WindowId)

Возвращает указанный AppWindowWindowId, если он доступен. Возвращает, null если WindowId невозможно сопоставить его с допустимым окном.

Hide()

Скрывает окно от всех представлений пользовательского интерфейса в системе, но сохраняет объект в живых.

Move(PointInt32)

Перемещает окно в указанную точку в координатах экрана.

MoveAndResize(RectInt32, DisplayArea)

Перемещает окно в указанную точку в заданной области отображения и задает его указанному размеру.

MoveAndResize(RectInt32)

Перемещает окно в указанную точку в координатах экрана и задает для него указанный размер.

MoveInZOrderAtBottom()

Перемещает текущее окно в нижнее окно в порядке Z.

MoveInZOrderAtTop()

Перемещает текущее окно, чтобы быть верхним окном в порядке Z.

MoveInZOrderBelow(WindowId)

Перемещает текущее окно под указанным окном в порядке Z.

Resize(SizeInt32)

Изменяет размер окна до указанного размера.

ResizeClient(SizeInt32)

Изменяет размер окна, чтобы вместить указанный размер клиентской области.

SaveCurrentPlacement()

Представляет управляемый системой контейнер для содержимого приложения.

SaveCurrentPlacementForAllPersistedStateIds()

Представляет управляемый системой контейнер для содержимого приложения.

SetCurrentPlacement(AppWindowPlacementDetails, Boolean)

Представляет управляемый системой контейнер для содержимого приложения.

SetIcon(IconId)

Задает значок окна с помощью указанного идентификатора значка.

SetIcon(String)

Задает значок окна с помощью указанного пути значка.

SetPresenter(AppWindowPresenter)

Применяет указанный выступающий к окну.

SetPresenter(AppWindowPresenterKind)

Применяет указанный тип докладчика к окну.

SetTaskbarIcon(IconId)

Задает значок панели задач с помощью указанного идентификатора значка.

SetTaskbarIcon(String)

Задает значок панели задач с помощью указанного пути значка.

SetTitleBarIcon(IconId)

Задает значок для строки заголовка окна с помощью указанного идентификатора значка.

SetTitleBarIcon(String)

Задает значок для строки заголовка окна с помощью указанного пути значка.

Show()

Отображает окно и активирует его.

Show(Boolean)

Отображает окно с параметром активации или нет.

ShowOnceWithRequestedStartupState()

Отображает окно с выступающим по умолчанию в запрошенном состоянии.

События

Имя Описание
Changed

Происходит, когда свойство окна изменилось, и система находится в "устойчивом состоянии" в течение времени.

Closing

Возникает при закрытии окна через системную доступность.

Destroying

Происходит при уничтожении окна.

Применяется к

См. также раздел