Window Класс

Определение

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

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
Атрибуты

Требования к 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 .

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

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