Setter.Value Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
Valore da applicare alla proprietà specificata da Setter.
Commenti
Come si può vedere dalla sintassi XAML, esistono diversi modi per specificare l'oggetto Value
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 Value
in un Setter. In caso contrario, viene generata un'eccezione (un errore di analisi o runtime, a seconda che venga Setter
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 Setter
se il valore della proprietà IsSealed in uno stile padre è true
. Viene anche segnalato dalla proprietà IsSealed su un singolo Setter
oggetto . 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 oggetto sealed Setter
genera un errore di runtime.
Stili e modelli
È possibile usare un setter in uno stile per applicare valori a qualsiasi proprietà di dipendenza. Tuttavia, è la Setter
proprietà Template di una classe derivata da Control che costituisce la maggior parte del markup XAML in una tipica Style
classe . Per Value
un Setter
oggetto with 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 negli scenari di templating del controllo, vedere Modelli di Style
controllo XAML.