Condividi tramite


FrameworkContentElement.Style Proprietà

Definizione

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à

Style

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

Si applica a