FrameworkElement.Style 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.
Ottiene o imposta lo stile utilizzato da questo elemento quando viene eseguito il rendering.
public:
property System::Windows::Style ^ Style { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style Style { get; set; }
member this.Style : System.Windows.Style with get, set
Public Property Style As Style
Valore della proprietà
Stile applicato e non predefinito per l'elemento, se presente. In caso contrario, null. Il valore predefinito per un oggetto costruito FrameworkElement predefinito è null.
Esempio
Nell'esempio seguente viene definito uno stile in un dizionario risorse.
<Page.Resources>
<Style TargetType="Border" x:Key="PageBackground">
<Setter Property="Background" Value="Blue"/>
</Style>
<Border Style="{StaticResource PageBackground}">
</Border>
Commenti
Per i controlli, lo stile corrente viene spesso fornito da uno stile predefinito dal tema dei controlli o dagli stili generalmente applicati ai controlli di quel tipo in base alle risorse a livello di pagina o applicazione (uno stile implicito). Questa proprietà non imposta o restituisce stili predefiniti (tema), ma restituisce uno stile implicito o uno stile esplicito che agisce sull'elemento. Nel caso di stili impliciti o espliciti, non importa se lo stile viene specificato come risorsa o definito localmente.
L'impostazione degli stili presenta alcune restrizioni. È possibile reimpostare l'intera Style proprietà su un nuovo Style oggetto in qualsiasi momento, che forza la ricomposizione del layout. Tuttavia, non appena tale stile viene utilizzato da un elemento caricato, deve Style essere considerato sealed. Se si tenta di apportare una modifica a qualsiasi singola proprietà di uno stile in uso ,ad esempio qualsiasi elemento all'interno dell'insieme di Setters, viene generata un'eccezione. Uno stile definito nel markup viene considerato in uso non appena viene caricato da un dizionario risorse (per le risorse) o la pagina in cui è contenuta viene caricata (per gli stili inline).
Style è una proprietà di dipendenza con precedenza speciale. Lo stile del set locale opera in genere con la precedenza più alta nel sistema di proprietà. Se è Style null a questo punto, durante il caricamento il sistema di proprietà verifica la presenza di stili impliciti nelle risorse locali o dell'applicazione che specificano tale tipo. Se lo stile è ancora Null dopo questo passaggio, lo stile di azione per scopi di presentazione deriva in genere dallo stile predefinito (tema), ma lo stile predefinito non viene restituito nel valore della Style proprietà. Vedere Precedenza del valore della proprietà di dipendenza o applicazione di stili e modelli.
Utilizzo degli attributi XAML
<object Style="{resourceExtension styleResourceKey}"/>
Utilizzo dell'elemento della proprietà XAML
Valori XAML
resourceExtension Uno dei seguenti: o . Vedi Risorse XAML.
styleResourceKey Chiave che identifica lo stile richiesto. La chiave fa riferimento a una risorsa esistente in un oggetto ResourceDictionary.
Annotazioni
La sintassi degli elementi proprietà è tecnicamente possibile, ma non consigliata per la maggior parte degli scenari di stile. Vedere Stili e modelli inline. Un riferimento di associazione tramite TemplateBinding o Binding è anche possibile, ma non comune.
Informazioni sulle proprietà di dipendenza
| Elemento | Valore |
|---|---|
| Campo Identificatore | StyleProperty |
Proprietà dei metadati impostate su true |
AffectsMeasure |