WindowChrome WindowChrome WindowChrome WindowChrome Class

Определение

Представляет объект, описывающий настройки неклиентской области окна.Represents an object that describes the customizations to the non-client area of a window.

public ref class WindowChrome : System::Windows::Freezable
public class WindowChrome : System.Windows.Freezable
type WindowChrome = class
    inherit Freezable
Public Class WindowChrome
Inherits Freezable
Наследование

Комментарии

WindowChrome Класс позволяет расширить содержимое Windows Presentation Foundation (WPF) в неклиентскую область окна, которая обычно зарезервирована для диспетчера окон операционной системы.The WindowChrome class enables you to extend Windows Presentation Foundation (WPF) content into the non-client area of a window that is typically reserved for the operating system's window manager.

Стандартные окнаStandard Windows

Стандартные окна состоят из двух перекрывающихся прямоугольников.Standard windows are composed of two overlapping rectangles. Внешний прямоугольник — это неклиентская область, которая часто называется Chrome.The outer rectangle is the non-client area, which is often referred to as chrome. Он рисуется и управляется диспетчером окон операционной системы.It is drawn and managed by the operating system's window manager. Его измерения определяются стандартными параметрами операционной системы.Its dimensions are determined by standard operating system settings. Неклиентский кадр предоставляет стандартные функции и поведения окон.The non-client frame provides standard window features and behaviors. К ним относятся кнопки субтитров («Minimize», «развернуть» и «закрыть»), «поведение окна», «изменение размера и перемещения», значок приложения, заголовок и системное меню.These include caption buttons (Minimize, Maximize, and Close), the window border, resize and move behaviors, the application icon and title, and the system menu. Внутренний прямоугольник является клиентской областью.The inner rectangle is the client area. Он содержит содержимое приложения, а также его прорисовку и управление с помощью приложения.It contains the contents of your application, and it is drawn and managed by the application. Дополнительные сведения о Windows в приложениях WPF см. в разделе Общие сведения об окнах WPF.For more information about windows in WPF applications, see WPF Windows Overview.

На следующем рисунке показаны части стандартного окна.The following illustration shows the parts of a standard window.

Элементы окнаWindow elements

Настраиваемые окнаCustom Windows

Можно настроить границу окна, задав Window.WindowStyle для None свойства значение или с помощью WindowChrome класса.You can customize a window border by setting the Window.WindowStyle property to None or by using the WindowChrome class.

WindowStyle. NoneWindowStyle.None

Одним из способов настройки внешнего вида окна приложения WPF является присвоение Window.WindowStyle Noneсвойству значения.One way to customize the appearance of a WPF application window is to set the Window.WindowStyle property to None. Это приведет к удалению неклиентской рамки из окна и покидает только клиентскую область, к которой можно применить пользовательский стиль.This removes the non-client frame from the window and leaves only the client area, to which you can apply a custom style. Однако при удалении неклиентской рамки также теряются и предоставляемые ею функции и поведения системы, такие как кнопки заголовка и изменение размера окна.However, when the non-client frame is removed, you also lose the system features and behaviors that it provides, such as caption buttons and window resizing. Другой побочный результат заключается в том, что окно будет охватывать панель задач Windows, когда она развернута.Another side effect is that the window will cover the Windows taskbar when it is maximized. Параметр WindowStyle.None позволяет создать полностью настраиваемое приложение, но также требует, чтобы в приложении была реализована пользовательская логика для имитации стандартного поведения окна.Setting WindowStyle.None enables you to create a completely custom application, but also requires that you implement custom logic in your application to emulate standard window behavior.

виндовчромеWindowChrome

Чтобы настроить окно, сохранив его стандартные функциональные возможности, можно использовать WindowChrome класс.To customize a window while retaining its standard functionality, you can use the WindowChrome class. WindowChrome Класс отделяет функциональность рамки окна от визуальных элементов и позволяет управлять границей между клиентской и неклиентской областями окна приложения.The WindowChrome class separates the functionality of the window frame from the visuals, and lets you control the boundary between the client and non-client areas of your application window. WindowChrome Класс позволяет разместить содержимое WPF в рамке окна путем расширения клиентской области для покрытия неклиентской области.The WindowChrome class lets you put WPF content in the window frame by extending the client area to cover the non-client area. В то же время поведение системы остается в двух невидимых областях. размеры областей границ и заголовков. **At the same time, it retains system behaviors through two invisible areas; the resize border and caption areas.

Создание настраиваемого окна с помощью класса состоит из WindowChrome двух основных частей.There are two main parts to creating a custom window using the WindowChrome class. Во-первых, вы настраиваете неклиентскую часть окна, задавая свойства, WindowChrome предоставляемые объекту.First, you customize the non-client part of the window by setting properties exposed on the WindowChrome object. Затем укажите шаблон для окна, определяющего часть приложения, которая будет расширена в неклиентской области. WindowChrome Для объекта доступны ResizeBorderThicknessсвойства, CaptionHeight ,CornerRadiusи .GlassFrameThicknessThen you provide a template for the window that defines the part of your application that is extended into the non-client area.The properties exposed on the WindowChrome object are ResizeBorderThickness, CaptionHeight, CornerRadius, and GlassFrameThickness.

ResizeBorderThickness Свойство задает невидимую границу вокруг внешнего окна приложения, которую пользователь может щелкнуть и перетащить, чтобы изменить размер окна.The ResizeBorderThickness property specifies an invisible border around the outside of the application window that the user can click-and-drag to resize the window.

CaptionHeight Свойство указывает невидимую область в верхней части окна, которая включает поведение системы, обычно связанных с заголовком.The CaptionHeight property specifies an invisible area at the top of the window that enables system behaviors typically associated with the title bar. К таким поведениям относятся: щелкните и перетащите, чтобы переместить окно, дважды щелкните, чтобы развернуть окно, и щелкните правой кнопкой мыши, чтобы открыть системное меню.These behaviors include: click and drag to move the window, double-click to maximize the window, and right-click to show the system menu.

В области границы и подписи для изменения размера отсутствуют визуальные элементы. они определяют только области, реагирующие на ввод и позволяющие стандартные системные поведения окон.The resize border and caption area do not have any visual elements; they only define areas that respond to input and enable standard system-provided window behaviors.

CornerRadius Свойство определяет величину округления углов окна.The CornerRadius property specifies the amount that the corners of the window are rounded. Это свойство не оказывает никакого влияния, если для окна включен стеклянный фрейм.This property does not have any effect if the glass frame is enabled for a window.

GlassFrameThickness Свойство задает ширину стеклянного фрейма вокруг окна.The GlassFrameThickness property specifies the width of the glass frame around the window. По умолчанию используется системное значение, заданное WindowNonClientFrameThickness свойством, для имитации внешнего вида стандартного окна.By default, it uses the system value specified by the WindowNonClientFrameThickness property to emulate the appearance of a standard window. При использовании стеклянного фрейма становятся видимыми и интерактивными кнопки заголовков для сворачивания, развертывания и закрытия.When the glass frame is used, the caption buttons for Minimize, Maximize, and Close are visible and interactive. Приложение отвечает за отображение значка приложения и текста заголовка.The application is responsible for displaying the application icon and caption text. Можно задать GlassFrameThickness свойство, чтобы увеличить или уменьшить стеклянную рамку по умолчанию.You can set the GlassFrameThickness property to make the glass frame wider or narrower than the default.

Внимание!

Размер кнопок заголовка не меняется при GlassFrameThickness изменении свойства.The size of the caption buttons does not change when the GlassFrameThickness property is changed. Если высота верхней границы стеклянной рамки меньше высоты кнопок заголовка, кнопки заголовка не будут видны полностью.If the height of the top of the glass frame is less than the height of the caption buttons, the caption buttons will not be completely visible.

Чтобы создать пользовательское окно без стеклянного фрейма, установите GlassFrameThickness для свойства однородное значение 0.To make a custom window that does not have a glass frame, set the GlassFrameThickness property to a uniform value of 0. Это приведет к отключению и скрытию стандартных кнопок заголовка.This will disable and hide the standard caption buttons.

Чтобы расширить рамку стекла для покрытия всего окна, установите GlassFrameThickness для свойства отрицательное значение на любой стороне.To extend the glass frame to cover the entire window, set the GlassFrameThickness property to a negative value on any side. Если свойству присвоено отрицательное значение для любой стороны, его Приводимое значение будет GlassFrameCompleteThicknessравно. GlassFrameThicknessWhen the GlassFrameThickness property is set to a negative value for any side, its coerced value will be equal to GlassFrameCompleteThickness.

Примечание

Aero — это набор визуальных улучшений внешнего вида и функций рабочего стола Windows, появившихся в Windows Vista.Aero is a set of visual enhancements to the look and functionality of the Windows desktop that was introduced in Windows Vista. Одной из более визуально очевидных функций Aero являются полупрозрачные границы окон.One of the more visually obvious features of Aero is translucent glass window borders. Windows Aero включается компонентом "Композиция рабочего стола" диспетчер окон рабочего стола (DWM).Windows Aero is enabled by the desktop composition feature of the Desktop Window Manager (DWM).

Эффекты стекла Windows Aero Glass не поддерживаются во всех операционных системах и могут быть отключены в поддерживаемых операционных системах.Windows Aero glass effects are not supported on all operating systems, and can be disabled on supported operating systems. Если Windows Aero недоступен, стеклянный фрейм не будет отображаться независимо GlassFrameThickness от значения свойства.If Windows Aero is not available, the glass frame will not be displayed regardless of the GlassFrameThickness property value. Область границ, заданная этим свойством, будет отображаться черным. IsGlassEnabled Проверьте свойство, чтобы убедиться, что эффекты прозрачности Windows Aero доступны.The border area specified by this property will appear black instead.Check the IsGlassEnabled property to verify that Windows Aero glass effects are available. Если эффекты прозрачности недоступны, необходимо предоставить альтернативный стиль окна, который не использует стеклянный фрейм, или использовать стандартное окно, установив для стиля окна значение null.If glass effects are not available, you should provide an alternate window style that does not use the glass frame or use the standard window by setting the window style to null.

Содержимое WPF расширяется в рамку окна путем указания ControlTemplate, определяющего внешний вид и поведение содержимого фрейма.You extend your WPF content into the window frame by specifying a ControlTemplate that defines the appearance and behavior of the frame content. Для параметра TargetType объекта ControlTemplate задается тип настраиваемого окна.You set the TargetType of the ControlTemplate to the type of the window that you are customizing.

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

По умолчанию части любых визуальных элементов, находящихся в неклиентской области окна, не являются интерактивными.By default, the parts of any visual elements that are within the non-client area of the window are not interactive. Чтобы включить интерактивные элементы в неклиентской области, присоедините к элементу присоединенное свойство Виндовсчроме. Ишиттествисиблеинчроме и задайте для него значение true.To enable interactive elements in the non-client area, attach the WindowsChrome.IsHitTestVisibleInChrome attached property to the element and set it to true.

В следующей разметке XAML показаны основные элементы, необходимые для настройки окна с помощью класса Виндовчроме.The following XAML markup shows the main elements needed to customize a window using the WindowChrome class.

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

Первый метод задания присоединяет Виндовчроме к окну.The first setter attaches the WindowChrome to the window. Он использует все значения по умолчанию для свойств Виндовчроме, что делает окно похожим на стандартное окно.It uses all default values for the WindowChrome properties, which makes the window look like a standard window.

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

Шаблон окна должен указывать представление содержимого для отображения содержимого окна, указанного в приложении.The window template must specify a content presenter to display the contents of the window specified in your application. По умолчанию класс Виндовчроме расширяет клиентскую область для покрытия неклиентской границы.By default the WindowChrome class extends the client area to cover the non-client border. Чтобы раскрывать стеклянный фрейм, необходимо указать поле вокруг ContentPresenter.In order to uncover the glass frame, you need to specify a margin around the ContentPresenter. Эта разметка определяет границу с помощью белого фона вокруг представления содержимого для имитации внешнего вида стандартного окна.This markup specifies a border with a white background around the content presenter to emulate the appearance of a standard window. Он также задает поле, привязанное к свойству Виндовнонклиентфрамесиккнесс, которое получает системную ширину по умолчанию для рамки.It also specifies a margin that is bound to the WindowNonClientFrameThickness property, which gets the default system width for the frame.

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

Класс Виндовчроме не отображает значок и заголовок приложения. их необходимо добавить в границу как пользовательское содержимое.The application icon and title are not displayed by the WindowChrome class; they have to be added to the border as custom content. Следующий код XAML добавляет изображение и TextBlock для вывода значка и заголовка.The following XAML adds an image and a textblock to display the icon and title. Оба элемента привязаны к соответствующим свойствам в окне.Both elements are bound to the corresponding properties on the window. Ширина изображения привязана к ширине Смалликонсизе, которая получает системный размер по умолчанию для значка.The image width is bound to the SmallIconSize width, which gets the default system size for the icon. Присоединенное свойство Ишиттествисиблеинчроме устанавливается на изображении, чтобы оно может принимать события мыши.The IsHitTestVisibleInChrome attached property is set on the image so that it can receive mouse events.

<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"/>  

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

WindowChrome() WindowChrome() WindowChrome() WindowChrome()

Инициализирует новый экземпляр класса WindowChrome.Initializes a new instance of the WindowChrome class.

Поля

CaptionHeightProperty CaptionHeightProperty CaptionHeightProperty CaptionHeightProperty

Идентифицирует свойство зависимостей CaptionHeight.Identifies the CaptionHeight dependency property.

CornerRadiusProperty CornerRadiusProperty CornerRadiusProperty CornerRadiusProperty

Идентифицирует свойство зависимостей CornerRadius.Identifies the CornerRadius dependency property.

GlassFrameThicknessProperty GlassFrameThicknessProperty GlassFrameThicknessProperty GlassFrameThicknessProperty

Идентифицирует свойство зависимостей GlassFrameThickness.Identifies the GlassFrameThickness dependency property.

IsHitTestVisibleInChromeProperty IsHitTestVisibleInChromeProperty IsHitTestVisibleInChromeProperty IsHitTestVisibleInChromeProperty

Идентифицирует свойство зависимостей System.Windows.Shell.WindowChrome.IsHitTestVisibleInChrome.Identifies the System.Windows.Shell.WindowChrome.IsHitTestVisibleInChrome dependency property.

NonClientFrameEdgesProperty NonClientFrameEdgesProperty NonClientFrameEdgesProperty NonClientFrameEdgesProperty

Идентифицирует свойство зависимостей NonClientFrameEdges.Identifies the NonClientFrameEdges dependency property.

ResizeBorderThicknessProperty ResizeBorderThicknessProperty ResizeBorderThicknessProperty ResizeBorderThicknessProperty

Идентифицирует свойство зависимостей ResizeBorderThickness.Identifies the ResizeBorderThickness dependency property.

ResizeGripDirectionProperty ResizeGripDirectionProperty ResizeGripDirectionProperty ResizeGripDirectionProperty

Идентифицирует свойство зависимостей System.Windows.Shell.WindowChrome.ResizeGripDirection.Identifies the System.Windows.Shell.WindowChrome.ResizeGripDirection dependency property.

UseAeroCaptionButtonsProperty UseAeroCaptionButtonsProperty UseAeroCaptionButtonsProperty UseAeroCaptionButtonsProperty

Идентифицирует свойство зависимостей UseAeroCaptionButtons.Identifies the UseAeroCaptionButtons dependency property.

WindowChromeProperty WindowChromeProperty WindowChromeProperty WindowChromeProperty

Идентифицирует свойство зависимостей WindowChrome.Identifies the WindowChrome dependency property.

Свойства

CanFreeze CanFreeze CanFreeze CanFreeze

Возвращает значение, которое указывает, можно ли сделать объект неизменяемым.Gets a value that indicates whether the object can be made unmodifiable.

(Inherited from Freezable)
CaptionHeight CaptionHeight CaptionHeight CaptionHeight

Получает или задает высоту области названия в верхней части окна.Gets or sets the height of the caption area at the top of a window.

CornerRadius CornerRadius CornerRadius CornerRadius

Получает или задает значение, указывающее степень скругления углов окна.Gets or sets a value that indicates the amount that the corners of a window are rounded.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Возвращает DependencyObjectType, который создает обертку для типа CLRCLR данного экземпляра.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
GlassFrameCompleteThickness GlassFrameCompleteThickness GlassFrameCompleteThickness GlassFrameCompleteThickness

Получает равномерную толщину, равную -1.Gets a uniform thickness of -1.

GlassFrameThickness GlassFrameThickness GlassFrameThickness GlassFrameThickness

Получает или задает значение, указывающее ширину стеклянной границы окна.Gets or sets a value that indicates the width of the glass border around a window.

IsFrozen IsFrozen IsFrozen IsFrozen

Получает значение, указывающее, доступен ли объект для изменения в настоящее время.Gets a value that indicates whether the object is currently modifiable.

(Inherited from Freezable)
IsSealed IsSealed IsSealed IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
NonClientFrameEdges NonClientFrameEdges NonClientFrameEdges NonClientFrameEdges

Получает или задает значение, указывающее, какие границы рамки окна не принадлежат клиенту.Gets or sets a value that indicates which edges of the window frame are not owned by the client.

ResizeBorderThickness ResizeBorderThickness ResizeBorderThickness ResizeBorderThickness

Получает или задает значение, указывающее ширину границы для изменения размера окна.Gets or sets a value that indicates the width of the border that is used to resize a window.

UseAeroCaptionButtons UseAeroCaptionButtons UseAeroCaptionButtons UseAeroCaptionButtons

Получает или задает значение, указывающее, включена ли для кнопок заголовков Windows Aero проверка нажатия.Gets or sets a value that indicates whether hit-testing is enabled on the Windows Aero caption buttons.

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

WindowChrome WindowChrome WindowChrome WindowChrome

Получает или задает экземпляр типа WindowChrome, прикрепляемый к окну.Gets or sets the instance of WindowChrome that is attached to a window.

Методы

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Очищает локальное значение свойства, доступного только для чтения.Clears the local value of a read-only property. Очищаемое свойство задается объектом DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
Clone() Clone() Clone() Clone()

Создает редактируемую копию объекта Freezable, что позволяет выполнить глубокое копирование значений объекта.Creates a modifiable clone of the Freezable, making deep copies of the object's values. При копировании свойств зависимостей объекта этот метод копирует выражения (которые могут уже не быть разрешимыми), но не копирует анимации и их текущие значения.When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.

(Inherited from Freezable)
CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable)

Делает экземпляр клоном (глубокой копией) указанного объекта Freezable, используя базовые (без анимации) значения свойств.Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Inherited from Freezable)
CloneCurrentValue() CloneCurrentValue() CloneCurrentValue() CloneCurrentValue()

Создает редактируемую копию (глубокую копию) объекта Freezable с использованием его текущих значений.Creates a modifiable clone (deep copy) of the Freezable using its current values.

(Inherited from Freezable)
CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable)

Создает экземпляр редактируемой копии (глубокой копии) заданного объекта Freezable, используя текущие значения свойства.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Inherited from Freezable)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей.Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
CreateInstance() CreateInstance() CreateInstance() CreateInstance()

Инициализирует новый экземпляр класса Freezable.Initializes a new instance of the Freezable class.

(Inherited from Freezable)
CreateInstanceCore() CreateInstanceCore() CreateInstanceCore() CreateInstanceCore()

Создает новый экземпляр класса WindowChrome.Creates a new instance of the WindowChrome class.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
Freeze() Freeze() Freeze() Freeze()

Делает текущий объект неизменяемым и присваивает его свойству IsFrozen значение true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Inherited from Freezable)
FreezeCore(Boolean) FreezeCore(Boolean) FreezeCore(Boolean) FreezeCore(Boolean)

Делает объект Freezable нередактируемым или проверяет, можно ли его сделать нередактируемым.Makes the Freezable object unmodifiable or tests whether it can be made unmodifiable.

(Inherited from Freezable)
GetAsFrozen() GetAsFrozen() GetAsFrozen() GetAsFrozen()

Создает фиксированную копию объекта Freezable, используя базовые (не анимационные) значения свойств.Creates a frozen copy of the Freezable, using base (non-animated) property values. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Inherited from Freezable)
GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable)

Создает экземпляр фиксированной копии заданного объекта Freezable, используя базовые (не анимационные) значения свойства.Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Inherited from Freezable)
GetCurrentValueAsFrozen() GetCurrentValueAsFrozen() GetCurrentValueAsFrozen() GetCurrentValueAsFrozen()

Создает фиксированную копию объекта Freezable с использованием текущих значений свойств.Creates a frozen copy of the Freezable using current property values. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Inherited from Freezable)
GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable)

Создает текущий экземпляр замороженной копии указанного объекта Freezable.Makes the current instance a frozen clone of the specified Freezable. Если объект имеет анимированные свойства зависимостей, копируются их текущие анимированные значения.If the object has animated dependency properties, their current animated values are copied.

(Inherited from Freezable)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Получает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetIsHitTestVisibleInChrome(IInputElement) GetIsHitTestVisibleInChrome(IInputElement) GetIsHitTestVisibleInChrome(IInputElement) GetIsHitTestVisibleInChrome(IInputElement)

Получает значение присоединенного свойства System.Windows.Shell.WindowChrome.IsHitTestVisibleInChrome из указанного входного элемента.Gets the value of the System.Windows.Shell.WindowChrome.IsHitTestVisibleInChrome attached property from the specified input element.

GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetResizeGripDirection(IInputElement) GetResizeGripDirection(IInputElement) GetResizeGripDirection(IInputElement) GetResizeGripDirection(IInputElement)

Получает значение присоединенного свойства System.Windows.Shell.WindowChrome.ResizeGripDirection из указанного входного элемента.Gets the value of the System.Windows.Shell.WindowChrome.ResizeGripDirection attached property from the specified input element.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
GetWindowChrome(Window) GetWindowChrome(Window) GetWindowChrome(Window) GetWindowChrome(Window)

Получает значение вложенного свойства зависимостей WindowChrome из указанного элемента Window.Gets the value of the WindowChrome attached property from the specified Window.

InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостейRe-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnChanged() OnChanged() OnChanged() OnChanged()

Вызывается при изменении текущего объекта Freezable.Called when the current Freezable object is modified.

(Inherited from Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Обеспечивает создание соответствующих указателей контекста для элемента данных типа DependencyObjectType, который был только что задан.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Inherited from Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Inherited from Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Переопределяет реализацию DependencyObject для OnPropertyChanged(DependencyPropertyChangedEventArgs), чтобы также вызвать любой обработчик Changed в ответ на изменение свойства зависимостей типа Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Inherited from Freezable)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если таковое существует.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
ReadPreamble() ReadPreamble() ReadPreamble() ReadPreamble()

Обеспечивает доступ к Freezable из допустимого потока.Ensures that the Freezable is being accessed from a valid thread. Наследники объекта Freezable должны вызывать данный метод в начале любого APIAPI, который считывает элементы данных, не являющиеся свойствами зависимостей.Inheritors of Freezable must call this method at the beginning of any APIAPI that reads data members that are not dependency properties.

(Inherited from Freezable)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не меняя источник значения.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetIsHitTestVisibleInChrome(IInputElement, Boolean) SetIsHitTestVisibleInChrome(IInputElement, Boolean) SetIsHitTestVisibleInChrome(IInputElement, Boolean) SetIsHitTestVisibleInChrome(IInputElement, Boolean)

Задает значение присоединенного свойства System.Windows.Shell.WindowChrome.IsHitTestVisibleInChrome для указанного входного элемента.Sets the value of the System.Windows.Shell.WindowChrome.IsHitTestVisibleInChrome attached property on the specified input element.

SetResizeGripDirection(IInputElement, ResizeGripDirection) SetResizeGripDirection(IInputElement, ResizeGripDirection) SetResizeGripDirection(IInputElement, ResizeGripDirection) SetResizeGripDirection(IInputElement, ResizeGripDirection)

Задает значение присоединенного свойства System.Windows.Shell.WindowChrome.ResizeGripDirection для указанного входного элемента.Sets the value of the System.Windows.Shell.WindowChrome.ResizeGripDirection attached property on the specified input element.

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
SetWindowChrome(Window, WindowChrome) SetWindowChrome(Window, WindowChrome) SetWindowChrome(Window, WindowChrome) SetWindowChrome(Window, WindowChrome)

Задает значение присоединенного свойства WindowChrome указанного объекта Window.Sets the value of the WindowChrome attached property on the specified Window.

ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
WritePostscript() WritePostscript() WritePostscript() WritePostscript()

Вызывает событие Changed для объекта Freezable и вызывает его метод OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Классы, производные от Freezable, должны вызывать этот метод в конце любого API, который изменяет члены класса, не сохраненные в виде свойств зависимостей.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Inherited from Freezable)
WritePreamble() WritePreamble() WritePreamble() WritePreamble()

Проверяет, что объект Freezable не заморожен и доступ к нему осуществляется из допустимого контекста потока.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Наследники объекта Freezable должны вызывать данный метод в начале любого APIAPI, который выполняет запись в элементах данных, не являющихся свойствами зависимостей.Freezable inheritors should call this method at the beginning of any APIAPI that writes to data members that are not dependency properties.

(Inherited from Freezable)

События

Changed Changed Changed Changed

Происходит, когда изменяется класс Freezable или объект, который входит в его состав.Occurs when the Freezable or an object it contains is modified.

(Inherited from Freezable)

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