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 Platform::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

Комментарии

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

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

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

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

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

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

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

Дополнительные члены интерфейса

IXamlSourceTransparency.IsBackgroundTransparent

Возвращает или задает значение, указывающее, является ли фон всех объектов DesktopWindowXamlSource в текущем потоке прозрачным.

Свойства

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

Методы

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

События

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

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

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