FrameworkContentElement.Style 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定此元素要使用的樣式。
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
屬性值
如果有,該元素的套用且非預設的風格。 否則為 null。 預設構造的 FrameworkContentElement 預設為 null。
範例
以下範例建立Resources根元素上的FlowDocument集合,並將它作為資源引用為特定風格。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>
備註
目前的樣式通常是由主題的預設樣式,或是資源在頁面或應用程式層級套用到該類型物件上的樣式(隱含樣式)。 此屬性不會設定或回傳預設(主題)樣式,但會回傳隱含式樣式或明確式樣式。 對於隱含式或顯式樣式而言,樣式是以資源存取或本地定義並不重要。
設定風格有一些限制。 你可以隨時將整個 Style 屬性重置為全新 Style ,這會強制重新組合版面。 然而,一旦該風格被負載元件 Style 使用,應視為密封狀態。 嘗試對任何正在使用風格的單一屬性(例如集合中的 Setters物件)進行變更,會觸發例外。 標記中定義的樣式,一旦從資源字典載入(資源)或所含頁面載入(內嵌樣式),即視為正在使用中。
Style 是一個具有特殊優先權的相依性質。 局部設定風格通常在財產系統中享有最高優先權。 如果此時 為 Style 空,載入時屬性系統會檢查定義資源中隱含的樣式指定該類型。 如果此步驟後樣式仍為空,則該樣式來自預設(主題)樣式,但預設樣式不會在屬性值中 Style 回傳。 參見 依賴性財產價值優先順序。
XAML 屬性使用方式
<object Style="{resourceExtension StyleResourceKey}"/>
XAML 值
resourceExtension 以下其中之一:,或。 請參閱 XAML 資源。
styleResourceKey 用來識別所要求風格的鑰匙。 該金鑰指 ResourceDictionary的是 .
備註
屬性元素語法技術上是可行的,但不建議使用。 請參見 內嵌樣式與範本。 也可以使用 TemplateBinding 或 Binding 來做綁定參考,但不常見。
相依財產資訊
| 項目 | 價值 |
|---|---|
| 識別碼欄位 | StyleProperty |
元資料屬性設為 true |
AffectsMeasure |