Setter.Value Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, применяемое к свойству, заданному методом задания.
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"/>
Значение свойства
Значение, применяемое к свойству, заданному методом задания.
Комментарии
Как видно из синтаксиса 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
с Setter
Property="Template"
почти всегда указывается как элемент свойства, содержащий элемент объекта ControlTemplate .
Если стиль используется для определения шаблона элемента управления, targetTypeStyle
элемента и TargetType элемента ControlTemplate для метода задания Control.Template всегда должны использовать одно и то же значение.
Метод задания шаблонов определяет базовое определение пользовательского интерфейса шаблона для экземпляра элемента управления, в котором применяется этот шаблон. Он также содержит визуальные состояния для элемента управления и другие определения пользовательского интерфейса на основе состояния, такие как переходы тем по умолчанию. Для сложного элемента управления, такого как ListBox, стандартный шаблон Style и ControlTemplate в могут содержать сотни строк XAML. Дополнительные сведения о роли в сценариях Style
создания шаблонов элементов управления см. в статье Шаблоны элементов управления XAML.