FrameworkContentElement.Style Egenskap

Definition

Hämtar eller anger formatmallen som ska användas av det här elementet.

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

Egenskapsvärde

Det tillämpade nondefault-formatet för elementet, om det finns. Annars, null. Standardvärdet för en standardkonstruerad FrameworkContentElement är null.

Exempel

I följande exempel upprättas en Resources samling på ett FlowDocument rotelement och refererar sedan till den som en resurs som ett specifikt format för en 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>

Kommentarer

Det aktuella formatet tillhandahålls ofta av ett standardformat från teman, eller från format som vanligtvis tillämpas på objekt av den typen av resurser på sid- eller programnivå (ett implicit format). Den här egenskapen anger eller returnerar inte standardformat (tema), men den returnerar det implicita formatet eller ett explicit format. När det gäller implicita eller explicita format spelar det ingen roll om formatet används som en resurs eller definieras lokalt.

Att ange formatmallarna har vissa begränsningar. Du kan återställa hela Style egenskapen till en ny Style när som helst, vilket tvingar fram en layoutomkomposition. Men så snart formatmallen används av ett inläst element bör det Style betraktas som förseglat. Om du försöker göra en ändring av en enskild egenskap i ett användningsformat (till exempel något i samlingen av Setters) genereras ett undantag. Ett format som definieras i markering anses användas så snart det läses in från en resursordlista (för resurser) eller så läses sidan som den finns i inläsningen (för infogade format).

Style är en beroendeegenskap med särskild prioritet. Den lokalt inställda formatmallen fungerar vanligtvis med högsta prioritet i egenskapssystemet. Om är Style null vid den här tidpunkten söker egenskapssystemet efter implicita format som definierade resurser som anger den typen under inläsningen av egenskapssystemet. Om formatet fortfarande är null efter det här steget kommer formatet från standardformatet (tema), men standardformatet returneras inte i Style egenskapsvärdet. Se Prioritet för beroendeegenskapsvärde.

XAML-attributanvändning

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

XAML-värden

resourceExtension Något av följande: , eller . Se XAML-resurser.

styleResourceKey Nyckeln som identifierar formatmallen som begärs. Nyckeln refererar till en befintlig resurs i en ResourceDictionary.

Note

Syntax för egenskapselement är tekniskt möjligt, men rekommenderas inte. Se Infogade format och mallar. En bindningsreferens med TemplateBinding eller Binding är också möjlig, men ovanlig.

Information om beroendeegenskap

Objekt Value
Identifierarfält StyleProperty
Metadataegenskaper inställda på true AffectsMeasure

Gäller för