Partilhar via


Setter.Value Propriedade

Definição

Obtém ou define o valor a ser aplicado à propriedade especificada pelo Setter.

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

Object

Platform::Object

IInspectable

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 Valor para um Setter 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 declarado na sintaxe do elemento de objeto XAML e o elemento de objeto está 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 de XAML, consulte Visão geral XAML ou guia de sintaxe XAML. Você pode usar a sintaxe de atributo para a maioria das propriedades da interface do usuário XAML e propriedades de 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 as propriedades Property e Value em um Setter. Caso contrário, uma exceção é gerada (uma exceção de análise ou um erro de runtime, dependendo se o Setter é criado em XAML ou modificado no código).

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

Estilos e modelos

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

Quando um Style é usado para definir um modelo de controle, o TargetType do elemento Style 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 modelo padrão Style e o ControlTemplate dentro podem ter centenas de linhas de XAML. Para obter mais informações sobre a função de Estilo em cenários de modelagem de controle, consulte Início Rápido: Modelos de controle.

Aplica-se a