Setter.Value Propiedad

Definición

Obtiene o establece el valor que se va a aplicar a la propiedad especificada por 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 de propiedad

Object

Platform::Object

IInspectable

Valor que se va a aplicar a la propiedad especificada por setter.

Comentarios

Como puedes ver en la sintaxis XAML, hay varias maneras de especificar el valor de un establecedor en XAML:

  • Como atributo, mediante un valor de cadena. Este valor de cadena se puede convertir implícitamente en un tipo específico de propiedad para casos simples, como establecer valores numéricos, valores con nombre de una enumeración o un identificador uniforme de recursos (URI).
  • Como un nuevo objeto completo que se declara en la sintaxis del elemento de objeto XAML, y el elemento de objeto se anida dentro de un uso de elemento de propiedad.
  • Como atributo que tiene un uso de extensión de marcado {StaticResource} entre comillas. Normalmente, el tipo de valor de la propiedad determina qué sintaxis es adecuada. Para obtener más información sobre los usos de XAML, consulta Introducción a XAML o Guía de sintaxis XAML. Puedes usar la sintaxis de atributo para la mayoría de las propiedades de la interfaz de usuario XAML y las propiedades de la interfaz de usuario que requieren específicamente un uso de elementos de propiedad o una referencia de recursos son menos comunes. Un uso de extensión de marcado {StaticResource} puede ser adecuado incluso para cadenas o valores numéricos si esos valores son compartidos por más de un estilo o propiedad.

Debe especificar las propiedades Property y Value en un establecedor. De lo contrario, se produce una excepción (ya sea una excepción de análisis o un error en tiempo de ejecución, en función de si el establecedor se crea en XAML o se modifica en el código).

Si tiene acceso a una instancia de Setter mediante código, no podrá cambiar el valor de ninguna propiedad de una instancia de Setter si el valor de la propiedad IsSealed en un style primario es true. Esto también lo notifica la propiedad IsSealed en un establecedor individual. El sistema establece estas propiedades en true cuando el tiempo de ejecución aplica estilos a los elementos de la interfaz de usuario y los muestra en la interfaz de usuario. Si se intenta cambiar un establecedor sellado, se produce un error en tiempo de ejecución.

Estilos y plantillas

Puede usar un establecedor en un estilo para aplicar valores a cualquier propiedad de dependencia. Pero es el establecedor de la propiedad Template de una clase derivada de Control que constituye la mayoría del marcado XAML en un estilo típico. El valor de un establecedor con Property="Template" casi siempre se especifica como un elemento de propiedad que contiene un elemento de objeto ControlTemplate .

Cuando se usa un style para definir una plantilla de control, el TargetType del elemento Style y el TargetType del elemento ControlTemplate para su establecedor Control.Template siempre deben usar el mismo valor.

El establecedor de plantillas define la definición de interfaz de usuario de plantilla básica para una instancia de control en la que se aplica esa plantilla. También contiene los estados visuales de un control y otras definiciones de interfaz de usuario basadas en estado, como transiciones de tema predeterminadas. Para un control complejo, como ListBox, la plantilla predeterminada Style y controlTemplate dentro pueden tener cientos de líneas de XAML. Para obtener más información sobre el rol de Estilo en escenarios de plantillas de control, consulte Inicio rápido: Plantillas de control.

Se aplica a