Window Класс

Определение

Пространство имен:

Windows.UI.Xaml

Представляет окно приложения.

public ref class Window sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Window

Public NotInheritable Class Window

Наследование

Object IInspectable Window

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем примере кода показано переопределение метода OnLaunched , созданного для пустого шаблона приложения в Microsoft Visual Studio. Этот код демонстрирует типичные шаблоны использования для свойств Current и Content и метода Activate .

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    // Create a Frame to act navigation context and navigate to the first page
    var rootFrame = new Frame();
    rootFrame.Navigate(typeof(BlankPage));

    // Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame;
    Window.Current.Activate();
}

Protected Overrides Sub OnLaunched(args As 
    Windows.ApplicationModel.Activation.LaunchActivatedEventArgs)

    ' Create a Frame to act navigation context and navigate to the first page
    Dim rootFrame As New Frame()
    rootFrame.Navigate(GetType(BlankPage))

    ' Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame
    Window.Current.Activate()
End Sub

Комментарии

Этот класс представляет окно текущего приложения. Таким же образом, как и свойство статического приложения , статическое свойство Current вернет объект окна приложения. Из этого объекта приложение может использовать диспетчер или определить размер окна из свойства Bounds . Наиболее распространенное использование окна — установка UIElement для содержимого , представляющего пользовательский интерфейс приложения. Обычно это делается как часть активации приложения (например, в переопределении OnLaunched ).) Содержимое этого окна можно изменить на протяжении всего времени существования окна.

Отсутствует представление XAML класса Window, так как оно не является элементом управления.

Объект Window — это просто поиск информации из CoreWindow, которая, в свою очередь, ссылается на окно, созданное системой.

Обязательно вызовите Activate в любом окне, используемом при первоначальной активации. Если вы используете шаблоны приложений по умолчанию из Microsoft Visual Studio, вызов Window.Activate является частью исходного кода в файле кода программной части app.xaml.

Класс LayoutAwarePage, являющийся частью некоторых шаблонов приложений в Microsoft Visual Studio, обрабатывает событие SizeChanged , которое используется для отслеживания визуальных состояний, соответствующих значениям ApplicationViewState. LayoutAwarePage также содержит код, который проверяет границы и использует это значение, чтобы повлиять на обработку событий ввода на уровне страницы.

Журнал версий

Версия Windows	Версия пакета SDK	Добавлено значение
1703	15063	Компоновщик
1903	18362	UIContext

Свойства

Bounds	Возвращает значение rect , содержащее высоту и ширину окна приложения в единицах эффективного (представления) пикселей.
Compositor	Возвращает compositor для этого окна.
Content	Возвращает или задает визуальный корень окна приложения.
CoreWindow	Возвращает внутренний основной объект для окна приложения.
Current	Возвращает окно текущего потока.
Dispatcher	Возвращает объект CoreDispatcher для Окна, который обычно является CoreDispatcher для потока пользовательского интерфейса.
UIContext	Возвращает идентификатор контекста для окна.
Visible	Возвращает значение, указывающее, отображается ли окно.

Методы

Activate()	Пытается активировать окно приложения, приведя его на передний план и задав для него фокус ввода.
Close()	Закрывает окно приложения.
SetTitleBar(UIElement)	Делает элемент XAML взаимодействовать с системой, как если бы это строка заголовка.

События

Activated	Происходит при успешной активации окна.
Closed	Происходит при закрытии окна.
SizeChanged	Происходит при первом отрисовке окна приложения или изменении размера отрисовки.
VisibilityChanged	Происходит при изменении значения свойства Visible .

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

• OnLaunched(LaunchActivatedEventArgs)
• CoreWindow
• Обработка активации приложения