FrameworkElement.Style Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene o imposta lo stile usato dall'elemento quando viene sottoposto a 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à

Style

Stile non predefinito applicato per l'elemento, se presente. In caso contrario, null. Il valore predefinito per un oggetto FrameworkElement costruito in modo 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 da risorse a livello di pagina o applicazione (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 è importante 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 in qualsiasi momento, che forza la ricomposizione di un layout. Tuttavia, non appena tale stile viene inserito in uso da un elemento caricato, l'oggetto Style deve 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 all'interno 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 recitazione 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.

Uso della sintassi XAML per gli attributi

<object Style="{resourceExtension styleResourceKey}"/>  

Utilizzo della sintassi XAML per elementi proprietà

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.

Nota

La sintassi degli elementi di 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 proprietà di dipendenza

Campo Identificatore	StyleProperty
Proprietà dei metadati impostate su true	AffectsMeasure