FrameworkContentElement.Style プロパティ

定義

名前空間:

System.Windows

アセンブリ:

PresentationFramework.dll

この要素が使用するスタイルを取得または設定します。

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

プロパティ値

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 null の場合、プロパティ システムの読み込み中に、その型を指定する定義済みリソースとして暗黙的なスタイルがチェックされます。 この手順の後もスタイルが null の場合、スタイルは既定の (テーマ) スタイルから取得されますが、既定のスタイルはプロパティ値で Style 返されません。 「依存関係プロパティの値の優先順位」を参照してください。

XAML 属性の使用方法

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

XAML 値

resourceExtension
次のいずれか: 、または 。 「XAML リソース」を参照してください。

styleResourceKey
要求されているスタイルを識別するキー。 キーは、 内の既存のリソースを ResourceDictionary参照します。

注意

プロパティ要素の構文は技術的には可能ですが、推奨されません。 「 インライン スタイルとテンプレート」を参照してください。 TemplateBinding または Binding を使用したバインディング参照も可能ですが、一般的ではありません。

依存プロパティ情報

識別子フィールド	StyleProperty
に設定されたメタデータ プロパティ true	AffectsMeasure