Setter.Value Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Ottiene o imposta il valore da applicare alla proprietà specificata da 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"/>

Valore della proprietà

Object

Platform::Object

IInspectable

Valore da applicare alla proprietà specificata da Setter.

Commenti

Come si può vedere dalla sintassi XAML, esistono diversi modi per specificare il valore per un setter in XAML:

• Come attributo, usando un valore stringa. Tale valore stringa può essere convertito in modo implicito in un tipo specifico della proprietà per i casi semplici, ad esempio l'impostazione di valori numerici, i valori denominati da un'enumerazione o un URI (Uniform Resource Identifier).
• Come nuovo oggetto completo dichiarato nella sintassi dell'elemento oggetto XAML e l'elemento oggetto viene annidato all'interno di un utilizzo degli elementi della proprietà.
• Come attributo con un utilizzo dell'estensione di markup {StaticResource} all'interno delle virgolette. In genere il tipo di valore della proprietà determina quale sintassi è appropriata. Per altre informazioni sugli usi XAML, vedere PanoramicaXAML o guida alla sintassi XAML. È possibile usare la sintassi degli attributi per la maggior parte delle proprietà dell'interfaccia utente XAML e le proprietà dell'interfaccia utente che richiedono specificamente un utilizzo di un elemento di proprietà o un riferimento alle risorse sono meno comuni. Un utilizzo dell'estensione di markup {StaticResource} può essere appropriato anche per stringhe o valori numerici se tali valori sono condivisi da più di uno stile o proprietà.

È necessario specificare sia le proprietà Proprietà che Valore in un setter. In caso contrario, viene generata un'eccezione (un'eccezione di analisi o un errore di runtime, a seconda che il setter venga creato in XAML o modificato nel codice).

Se si accede a un'istanza di Setter usando il codice, non è possibile modificare il valore di una proprietà di un'istanza di Setter se il valore della proprietà IsSealed in uno stile padre è true. Questo è segnalato anche dalla proprietà IsSealed su un singolo Setter. Il sistema imposta queste proprietà su true quando il runtime applica stili agli elementi dell'interfaccia utente e li visualizza nell'interfaccia utente. Il tentativo di modificare un setter bloccato genera un errore di runtime.

Stili e modelli

È possibile usare un setter in uno stile per applicare valori a qualsiasi proprietà di dipendenza. Ma è il Setter per la proprietà Template di una classe derivata da Control che costituisce la maggior parte del markup XAML in uno stile tipico. Valore per un setter con Property="Template" è quasi sempre specificato come elemento di proprietà che contiene un elemento oggetto ControlTemplate .

Quando viene usato uno stile per definire un modello di controllo, targetType dell'elemento Style e targetType dell'elemento ControlTemplate per il setterControl.Template deve usare sempre lo stesso valore.

Il setter modello definisce la definizione dell'interfaccia utente del modello di base per un'istanza di controllo in cui viene applicato tale modello. Contiene anche gli stati visivi per un controllo e altre definizioni dell'interfaccia utente basate su stato, ad esempio transizioni di tema predefinite. Per un controllo complesso, ad esempio ListBox, lo stile predefinito del modello e il controlloTemplate all'interno possono avere centinaia di righe di XAML. Per altre informazioni sul ruolo di Style negli scenari di templating del controllo, vedere Guida introduttiva: Modelli di controllo.