WindowChrome Класс

Определение

public ref class WindowChrome : System::Windows::Freezable

public class WindowChrome : System.Windows.Freezable

type WindowChrome = class
    inherit Freezable

Public Class WindowChrome
Inherits Freezable

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

Object

DispatcherObject

DependencyObject

Freezable

WindowChrome

Комментарии

Класс WindowChrome позволяет расширить содержимое Windows Presentation Foundation (WPF) в неклиентскую область окна, которое обычно зарезервировано для диспетчера окон операционной системы.

Стандартный Windows

Стандартные окна состоят из двух перекрывающихся прямоугольников. Внешний прямоугольник — это не клиентская область, которую часто называют хромом. Он рисуется и управляется диспетчером окон операционной системы. Его размеры определяются стандартными параметрами операционной системы. Фрейм, не относясь к клиенту, предоставляет стандартные функции и поведения окна. К ним относятся подпись кнопки (Свернуть, Развернуть и Закрыть), границы окна, изменения размера и перемещения, значок и заголовок приложения, а также системное меню. Внутренний прямоугольник является клиентской областью. Он содержит содержимое приложения и рисуется и управляется приложением. Дополнительные сведения о окнах в приложениях WPF см. в разделе Общие сведения о WINDOWS WPF.

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

Пользовательские окна

Границу окна можно настроить, задав Window.WindowStyle для свойства значение None или с помощью WindowChrome класса .

WindowStyle.None

Один из способов настроить внешний вид окна приложения WPF — задать Window.WindowStyle для свойства значение None. При этом фрейм, не являющийся клиентом, удаляется из окна и остается только клиентская область, к которой можно применить пользовательский стиль. Однако при удалении фрейма, не являющегося клиентом, вы также теряете предоставляемые им функции и поведения системы, такие как подпись кнопки и изменение размера окна. Другой побочный эффект заключается в том, что окно будет охватывать панель задач Windows, когда она развернута. Параметр WindowStyle.None позволяет создать полностью настраиваемое приложение, но также требует реализации пользовательской логики в приложении для эмуляции стандартного поведения окна.

WindowChrome

Чтобы настроить окно с сохранением его стандартных функциональных возможностей, можно использовать WindowChrome класс . Класс WindowChrome отделяет функциональные возможности рамки окна от визуальных элементов и позволяет управлять границей между клиентской и не клиентской областями окна приложения. Класс WindowChrome позволяет поместить содержимое WPF в рамку окна, расширяя область клиента, чтобы охватить неклиентовую область. В то же время он сохраняет поведение системы через две невидимые области; размер границы и области подпись.

Создание пользовательского окна с помощью WindowChrome класса main. Сначала настраивается неклиентская часть окна, задав свойства, предоставляемые объекту WindowChrome . Затем вы предоставляете шаблон для окна, определяющего часть приложения, которая распространяется на неклиентовую область. Для объекта доступны WindowChrome свойства , CaptionHeight, CornerRadiusи GlassFrameThickness.ResizeBorderThickness

Свойство ResizeBorderThickness задает невидимую границу за пределами окна приложения, которую пользователь может щелкнуть и перетащить для изменения размера окна.

Свойство CaptionHeight задает невидимую область в верхней части окна, которая обеспечивает поведение системы, обычно связанное с заголовком окна. К таким вариантам поведения относятся: щелчок и перетаскивание для перемещения окна, двойной щелчок, чтобы развернуть окно, и щелчок правой кнопкой мыши, чтобы отобразить системное меню.

Границы изменения размера и области подпись не содержат визуальных элементов; они определяют только области, которые реагируют на входные данные, и обеспечивают стандартное поведение окна, предоставляемое системой.

Свойство CornerRadius указывает, насколько скругляются углы окна. Это свойство не действует, если для окна включена стеклянная рамка.

Свойство GlassFrameThickness задает ширину стеклянной рамки вокруг окна. По умолчанию используется системное значение, заданное свойством WindowNonClientFrameThickness , для эмуляции внешнего вида стандартного окна. Когда используется стеклянная рамка, подпись кнопки Свернуть, Развернуть и Закрыть видны и интерактивны. Приложение отвечает за отображение значка приложения и подпись текста. Вы можете задать GlassFrameThickness свойство , чтобы сделать стеклянную рамку шире или более узкой, чем по умолчанию.

Чтобы создать пользовательское окно без стеклянной рамки, присвойте свойству GlassFrameThickness равное однородное значение 0. При этом стандартные кнопки подпись будут отключены и скрыты.

Чтобы расширить стеклянную рамку, чтобы охватить все окно, задайте GlassFrameThickness для свойства отрицательное значение с любой стороны. Если свойству GlassFrameThickness присвоено отрицательное значение для любой стороны, его принуждать значение будет равно GlassFrameCompleteThickness.

Эффекты стекла Windows Aero поддерживаются не во всех операционных системах и могут быть отключены в поддерживаемых операционных системах. Если windows Aero недоступен, стеклянная рамка не будет отображаться независимо от GlassFrameThickness значения свойства . Область границы, указанная этим свойством, будет выглядеть черной. Проверьте свойство , IsGlassEnabled чтобы убедиться, что эффекты стекла Windows Aero доступны. Если стеклянные эффекты недоступны, следует указать альтернативный стиль окна, который не использует стеклянную рамку или стандартное окно, установив для стиля окна значение NULL.

Содержимое WPF расширяется в рамку окна, указывая шаблон ControlTemplate, определяющий внешний вид и поведение содержимого кадра. Для параметра TargetType элемента ControlTemplate задается тип настраиваемого окна.

<ControlTemplate TargetType="{x:Type local:MainWindow}">

По умолчанию части визуальных элементов, которые находятся в не клиентской области окна, не являются интерактивными. Чтобы включить интерактивные элементы в не клиентской области, присоедините присоединенное свойство WindowsChrome.IsHitTestVisibleInChrome к элементу и присвойте ему значение true.

В следующей разметке XAML показаны main элементов, необходимых для настройки окна с помощью класса WindowChrome.

<Style x:Key="StandardStyle" TargetType="{x:Type local:MainWindow}">
    <Setter Property="shell:WindowChrome.WindowChrome">
        <Setter.Value>
            <shell:WindowChrome />
        </Setter.Value>
    </Setter>
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:MainWindow}">
                <Grid>
                    <Border Background="White"
                            Margin="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=WindowNonClientFrameThickness}">
                        <ContentPresenter Content="{TemplateBinding Content}" />
                    </Border>
                    <TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Title}"
                               VerticalAlignment="Top" HorizontalAlignment="Left"
                               Margin="36,8,0,0"/>
                    <Image Source="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Icon}"
                           VerticalAlignment="Top" HorizontalAlignment="Left"
                           Margin="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=(shell:WindowChrome.WindowChrome).ResizeBorderThickness}"
                           Width="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=SmallIconSize.Width}"
                           shell:WindowChrome.IsHitTestVisibleInChrome="True"/>
                </Grid>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

Первый метод задания присоединяет WindowChrome к окну. Он использует все значения по умолчанию для свойств WindowChrome, что делает окно похожим на стандартное окно.

<Setter Property="shell:WindowChrome.WindowChrome">
    <Setter.Value>
        <shell:WindowChrome />
    </Setter.Value>
</Setter>

Шаблон окна должен указать докладчика содержимого для отображения содержимого окна, указанного в приложении. По умолчанию класс WindowChrome расширяет область клиента, чтобы охватить границу, не являющейся клиентской. Чтобы обнаружить стеклянную рамку, необходимо указать поле вокруг ContentPresenter. Эта разметка задает границу с белым фоном вокруг докладчика содержимого для эмуляции внешнего вида стандартного окна. Он также указывает поле, привязанное к свойству WindowNonClientFrameThickness, которое получает системную ширину по умолчанию для кадра.

<Border Background="White"
    Margin="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=WindowNonClientFrameThickness}">
    <ContentPresenter Content="{TemplateBinding Content}" />
</Border>

Значок и заголовок приложения не отображаются классом WindowChrome; они должны быть добавлены в границу как пользовательское содержимое. Следующий код XAML добавляет изображение и текстовый блок для отображения значка и заголовка. Оба элемента привязаны к соответствующим свойствам окна. Ширина изображения привязана к ширине SmallIconSize, которая получает системный размер значка по умолчанию. Присоединенное свойство IsHitTestVisibleInChrome задается на изображении, чтобы получать события мыши.

<Image Source="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Icon}"
       VerticalAlignment="Top" HorizontalAlignment="Left"
       Margin="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=(shell:WindowChrome.WindowChrome).ResizeBorderThickness}"
       Width="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=SmallIconSize.Width}"
       shell:WindowChrome.IsHitTestVisibleInChrome="True"/>

<TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Title}"
           VerticalAlignment="Top" HorizontalAlignment="Left"
           Margin="36,8,0,0"/>

Конструкторы

Поля

Свойства

Присоединенные свойства

Методы

События

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