FrameworkContentElement.Style FrameworkContentElement.Style FrameworkContentElement.Style FrameworkContentElement.Style Property

Definizione

Ottiene o imposta lo stile che l'elemento deve usare.Gets or sets the style to be used by this element.

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.The applied, nondefault style for the element, if present. In caso contrario, null.Otherwise, null. Il valore predefinito per un oggetto FrameworkContentElement costruito in modo predefinito è null.The default for a default-constructed FrameworkContentElement is null.

Esempi

Nell'esempio seguente viene stabilita una Resources raccolta in un FlowDocument elemento radice e quindi viene fatto riferimento a essa come risorsa come uno Paragraphstile specifico per un oggetto.The following example establishes a Resources collection on a FlowDocument root element and then references it as a resource as a specific style for a 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 da temi o da stili applicati in genere a oggetti di quel tipo dalle risorse a livello di pagina o di applicazione (uno stile implicito).The current style is often provided by a default style from theming, or from styles generally applied to objects of that type by resources at page or application level (an implicit style). Questa proprietà non imposta o restituisce stili predefiniti (tema), ma restituisce lo stile implicito o uno stile esplicito.This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. Nel caso di stili impliciti o espliciti, non è importante se lo stile è accessibile come risorsa o definito localmente.In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

L'impostazione degli stili presenta alcune restrizioni.Setting the styles has some restrictions. È possibile reimpostare l' Style intera proprietà su un Style nuovo in qualsiasi momento, in modo da forzare una ricomposizione del layout.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Tuttavia, non appena lo stile viene utilizzato da un elemento caricato, Style deve essere considerato sealed.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Se si tenta di apportare una modifica a una singola proprietà di uno stile in uso (ad esempio qualsiasi elemento all'interno della Settersraccolta di), viene generata un'eccezione.Attempting to make a change to any individual property of an in-use style (such as anything within the collection of Setters) causes an exception to be thrown. Uno stile definito nel markup viene considerato in uso non appena viene caricato da un dizionario risorse (per le risorse) oppure la pagina in cui è contenuto è caricata (per gli stili inline).A style that is defined in markup is considered to be in use as soon as it is loaded from a resource dictionary (for resources), or the page it is contained within is loaded (for inline styles).

Styleè una proprietà di dipendenza con priorità speciale.Style is a dependency property with special precedence. Lo stile impostato localmente funziona in genere con la precedenza più elevata nel sistema di proprietà.The locally set style generally operates at the highest precedence in the property system. Se a questo punto ènull,duranteilcaricamentoilsistemadiproprietàcontrollaglistiliimpliciticomerisorsedefinitechespecificanoqueltipo.StyleIf the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that type. Se lo stile è ancora null dopo questo passaggio, lo stile deriva dallo stile predefinito (tema), ma lo stile predefinito non viene restituito nel Style valore della proprietà.If the style is still null after this step, then the style comes from the default (theme) style, but the default style is not returned in the Style property value. Vedere precedenza del valore della proprietà di dipendenza.See Dependency Property Value Precedence.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

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

Valori XAMLXAML Values

resourceExtensionresourceExtension
Uno dei seguenti:, o.One of the following: , or . Vedere risorse XAML.See XAML Resources.

styleResourceKeystyleResourceKey
Chiave che identifica lo stile richiesto.The key that identifies the style being requested. La chiave fa riferimento a una risorsa esistente in ResourceDictionaryun oggetto.The key refers to an existing resource in a ResourceDictionary.

Nota

La sintassi degli elementi proprietà è tecnicamente possibile, ma non consigliata.Property element syntax is technically possible, but not recommended. Vedere stili e modelli inline.See Inline Styles and Templates. Un riferimento di associazione che utilizza TemplateBinding Binding o è anche possibile, ma non comune.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field StyleProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true AffectsMeasure

Si applica a