Setter.Value Свойство

Определение

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

Windows.UI.Xaml

Возвращает или задает значение, применяемое к свойству, заданному методом задания.

public:
 property Platform::Object ^ Value { Platform::Object ^ get(); void set(Platform::Object ^ value); };

IInspectable Value();

void Value(IInspectable value);

public object Value { get; set; }

var object = setter.value;
setter.value = object;

Public Property Value As Object

<Setter ...>
  <Setter.Value>
    objectValue
  </Setter.Value>
</Setter>
- or -
<Setter Value="attributeValue"/>
-or-
<Setter Value="extensionUsage"/>

Значение свойства

Object

Platform::Object

IInspectable

Значение, применяемое к свойству, заданному методом задания.

Комментарии

Как видно из синтаксиса XAML, задать значение для метода задания в XAML можно несколькими способами:

• В качестве атрибута используется строковое значение. Такое строковое значение может быть неявно преобразовано в тип свойства для простых случаев, таких как установка числовых значений, именованные значения из перечисления или универсальный код ресурса (URI).
• Как полный новый объект, объявленный в синтаксисе объектного элемента XAML, и объектный элемент вложен в использование элемента свойства.
• Как атрибут, имеющий использование расширения разметки {StaticResource} в кавычках. Как правило, тип значения свойства определяет, какой синтаксис подходит. Дополнительные сведения об использовании XAML см. в статье Общие сведения о XAML или Руководство по синтаксису XAML. Синтаксис атрибутов можно использовать для большинства свойств пользовательского интерфейса XAML, а свойства пользовательского интерфейса, которые требуют использования элемента свойства или ссылки на ресурс, являются менее распространенными. Использование расширения разметки {StaticResource} может подходить даже для строк или числовых значений, если эти значения совместно используются несколькими стилями или свойствами.

Необходимо указать свойства Свойство и Значение в методе задания. В противном случае возникает исключение (исключение синтаксического анализа или ошибка среды выполнения в зависимости от того, создается ли метод задания в XAML или изменяется в коде).

При доступе к экземпляру Setter с помощью кода нельзя изменить значение какого-либо свойства экземпляра Setter , если свойство IsSealed родительского стиля имеет значение true. Это также сообщается свойством IsSealed в отдельном методе задания. Система устанавливает для этих свойств значение true , когда среда выполнения применяет стили к элементам пользовательского интерфейса и отображает их в пользовательском интерфейсе. Попытка изменить запечатанный метод задания вызывает ошибку среды выполнения.

Стили и шаблоны

Метод задания в стиле можно использовать для применения значений к любому свойству зависимостей. Но это метод задания для свойства Template класса, производного от Control, который составляет большую часть разметки XAML в типичном стиле. Значение для метода задания с Property="Template" почти всегда указывается как элемент свойства, содержащий элемент объекта ControlTemplate .

Если для определения шаблона элемента управления используется стиль , TargetType элемента Style и TargetType элемента ControlTemplate для метода задания Control.Template всегда должны использовать одно и то же значение.

Метод задания шаблона определяет базовое определение пользовательского интерфейса шаблона для экземпляра элемента управления, в котором применяется этот шаблон. Он также содержит визуальные состояния для элемента управления и другие определения пользовательского интерфейса на основе состояния, такие как переходы темы по умолчанию. Для сложного элемента управления, такого как ListBox, стиль шаблона по умолчанию и ControlTemplate в могут содержать сотни строк XAML. Дополнительные сведения о роли стиля в сценариях создания шаблонов элементов управления см. в разделе Краткое руководство. Шаблоны элементов управления.