Setter.Value Propriedade

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

Valor da propriedade

O valor a ser aplicado à propriedade especificada pelo Setter.

Comentários

Como você pode ver na sintaxe XAML, há várias maneiras de especificar o Valuesetter em XAML:

• Como um atributo, usando um valor de cadeia de caracteres. Esse valor de cadeia de caracteres pode ser convertido implicitamente em um tipo específico de propriedade para casos simples, como definir valores numéricos, valores nomeados de uma enumeração ou um URI (Uniform Resource Identifier).
• Como um novo objeto completo que é declarado na sintaxe do elemento de objeto XAML, e o elemento objeto é aninhado dentro de um uso de elemento de propriedade.
• Como um atributo que tem um uso de extensão de marcação {StaticResource} entre aspas. Normalmente, o tipo de valor da propriedade determina qual sintaxe é apropriada. Para obter mais informações sobre usos XAML, consulte a visão geral XAML ou o guia de sintaxe XAML. Você pode usar a sintaxe de atributo para a maioria das propriedades da interface do usuário XAML e as propriedades da interface do usuário que exigem especificamente um uso de elemento de propriedade ou uma referência de recurso são menos comuns. Um uso de extensão de marcação {StaticResource} pode ser apropriado até mesmo para cadeias de caracteres ou valores numéricos se esses valores forem compartilhados por mais de um estilo ou propriedade.

Você deve especificar a Propriedade e Value as propriedades em um Setter. Caso contrário, uma exceção é gerada (uma exceção de análise ou um erro de runtime, dependendo se a Setter origem é criada em XAML ou modificada no código).

Se você estiver acessando uma instância do Setter usando código, não poderá alterar o valor de qualquer propriedade de uma Setter instância se o valor da propriedade IsSealed em um estilo pai for true. Isso também é relatado pela propriedade IsSealed em um indivíduo Setter. O sistema define essas propriedades para true quando o runtime aplica estilos a elementos da interface do usuário e as exibe na interface do usuário. A tentativa de alterar um lacrado Setter lança um erro de runtime.

Estilos e modelos

Você pode usar um Setter em um Estilo para aplicar valores a qualquer propriedade de dependência. Mas é para a Setter propriedade Template de uma classe derivada de controle que constitui a maior parte da marcação XAML em um típico Style. O Value para um Setter com Property="Template" é quase sempre especificado como um elemento de propriedade que contém um elemento de objeto ControlTemplate .

Quando um Estilo é usado para definir um modelo de controle, o TargetType do Style elemento e o TargetType do elemento ControlTemplate para seu setter Control.Template sempre devem usar o mesmo valor.

O setter de modelo define a definição básica da interface do usuário do modelo para uma instância de controle em que esse modelo é aplicado. Ele também contém os estados visuais de um controle e outras definições de interface do usuário baseadas em estado, como transições de tema padrão. Para um controle complexo, como ListBox, o estilo de modelo padrão e o ControlTemplate dentro podem ter centenas de linhas de XAML. Para obter mais informações sobre a função de cenários de Style modelagem de controle, consulte modelos de controle XAML.