Condividi tramite


FrameworkContentElement.Style Proprietà

Definizione

Ottiene o imposta lo stile da utilizzare da questo elemento.

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 FrameworkContentElement predefinito è null.

Esempio

Nell'esempio seguente viene stabilita una Resources raccolta su un FlowDocument elemento radice e quindi viene fatto riferimento come risorsa come stile specifico per un oggetto Paragraph.

<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 dal tema o dagli stili generalmente applicati agli oggetti di quel tipo da 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 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 del sistema di proprietà verifica la presenza di stili impliciti come risorse definite che specificano tale tipo. Se lo stile è ancora Null dopo questo passaggio, lo stile deriva dallo stile predefinito (tema), ma lo stile predefinito non viene restituito nel valore della Style proprietà. Vedere Precedenza del valore della proprietà di dipendenza.

Utilizzo degli attributi XAML

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

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. 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

Si applica a