FrameworkContentElement.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 che l'elemento deve usare.
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 non predefinito applicato per l'elemento, se presente. In caso contrario, null
. Il valore predefinito per un oggetto FrameworkContentElement costruito in modo predefinito è null
.
Esempio
Nell'esempio seguente viene stabilita una Resources raccolta in un FlowDocument elemento radice e quindi viene fatto riferimento come risorsa come stile specifico per un Paragraphoggetto .
<FlowDocument
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class=" SDKSample.Page2">
<FlowDocument.Resources>
<Style TargetType="{x:Type Paragraph}" x:Key="BluePara">
<Setter Property="Background" Value="Blue"/>
<Setter Property="FontSize" Value="18"/>
<Setter Property="Foreground" Value="LightBlue"/>
<Setter Property="FontFamily" Value="Trebuchet MS"/>
</Style>
</FlowDocument.Resources>
<Paragraph Style="{StaticResource BluePara}">Lorem ipsum etc.</Paragraph>
</FlowDocument>
Commenti
Lo stile corrente viene spesso fornito da uno stile predefinito da liing o dagli stili generalmente applicati agli oggetti di tale 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 lo stile implicito o uno stile esplicito. Nel caso di stili impliciti o espliciti, non importa se lo stile è accessibile come risorsa o definita in locale.
L'impostazione degli stili presenta alcune restrizioni. È possibile reimpostare l'intera Style proprietà in un nuovo Style in qualsiasi momento, che forza una ricomposizione del layout. Tuttavia, non appena tale stile viene inserito in uso da un elemento caricato, deve Style essere considerato bloccato. Il tentativo di apportare una modifica a qualsiasi singola proprietà di uno stile in uso (ad esempio qualsiasi elemento all'interno dell'insieme di ) causa l'generazione di Settersun'eccezione. Uno stile definito nel markup viene considerato in uso non appena viene caricato da un dizionario risorse (per le risorse) o la pagina contenuta all'interno viene caricata (per gli stili inline).
Style è una proprietà di dipendenza con precedenza speciale. Lo stile del set locale opera in genere al massimo della precedenza nel sistema delle proprietà. Se l'oggetto è null a questo punto, durante il Style caricamento il sistema delle proprietà controlla gli stili impliciti come risorse definite che specificano tale tipo. Se lo stile è ancora null dopo questo passaggio, lo stile proviene dallo stile predefinito (tema), ma lo stile predefinito non viene restituito nel valore della Style proprietà. Vedere Precedenza del valore della proprietà Dependency.
Uso della sintassi XAML per gli attributi
<object Style="{resourceExtension StyleResourceKey}"/>
Valori XAML
resourceExtension
Uno dei seguenti: , o . Vedere Risorse XAML.
styleResourceKey
Chiave che identifica lo stile richiesto. La chiave fa riferimento a una risorsa esistente in un ResourceDictionaryoggetto .
Nota
La sintassi dell'elemento proprietà è tecnicamente possibile, ma non consigliata. Vedere Stili e modelli inline. Un riferimento di associazione usando TemplateBinding o Binding è anche possibile, ma non comune.
Informazioni proprietà di dipendenza
Campo Identificatore | StyleProperty |
Proprietà dei metadati impostate su true |
AffectsMeasure |