Setter.Value Свойство

Определение

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

Microsoft.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, существует множество способов указать Value для метода задания в XAML:

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

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

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

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

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

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

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