FrameworkContentElement.Style プロパティ


この要素が使用するスタイルを取得または設定します。Gets or sets the style to be used by this element.

 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


要素に適用される既定以外のスタイル (存在する場合)。The applied, nondefault style for the element, if present. それ以外の場合は nullOtherwise, null. 既定で構築された FrameworkContentElement の既定値は null です。The default for a default-constructed FrameworkContentElement is null.

次の例では、FlowDocument ルート要素で Resources コレクションを確立し、Paragraphの特定のスタイルとしてリソースとして参照します。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.

  x:Class=" SDKSample.Page2">
    <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"/>
  <Paragraph Style="{StaticResource BluePara}">Lorem ipsum etc.</Paragraph>


現在のスタイルは、通常、テーマからの既定のスタイル、またはページレベルまたはアプリケーションレベルのリソースによってその型のオブジェクトに適用されるスタイル (暗黙的なスタイル) によって提供されます。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). このプロパティは、既定 (テーマ) のスタイルを設定または返しませんが、暗黙的なスタイルまたは明示的なスタイルを返します。This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. 暗黙的または明示的なスタイルの場合、スタイルがリソースとしてアクセスされているか、ローカルに定義されているかは関係ありません。In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

スタイルの設定にはいくつかの制限があります。Setting the styles has some restrictions. Style のプロパティ全体を、いつでも新しい Style にリセットできます。これにより、レイアウト再合成が強制的に適用されます。You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. ただし、読み込まれた要素によってそのスタイルが使用されるとすぐに、Style が sealed と見なされます。However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. 使用中のスタイル (Settersのコレクション内にあるものなど) の個々のプロパティを変更しようとすると、例外がスローされます。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. マークアップで定義されたスタイルは、リソースディクショナリ (リソースの場合) から読み込まれたとき、またはそれが含まれているページが読み込まれるとすぐに使用中と見なされます (インラインスタイルの場合)。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 は、特殊な優先順位を持つ依存関係プロパティです。Style is a dependency property with special precedence. ローカルで設定されたスタイルは、一般に、プロパティシステムで最も優先順位が高いものになります。The locally set style generally operates at the highest precedence in the property system. この時点で Style が null の場合、プロパティシステムの読み込み中に、その型を指定する定義済みのリソースとして暗黙的なスタイルを確認します。If the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that type. この手順の後にスタイルが null の場合、スタイルは既定 (テーマ) のスタイルになりますが、既定のスタイルは Style プロパティ値では返されません。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. 依存関係プロパティ値の優先順位」を参照してください。See Dependency Property Value Precedence.

XAML 属性の使用方法XAML Attribute Usage

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


次のいずれか:、または。One of the following: , or . XAML リソース」を参照してください。See XAML Resources.

要求されているスタイルを識別するキー。The key that identifies the style being requested. キーは、ResourceDictionary内の既存のリソースを参照します。The key refers to an existing resource in a ResourceDictionary.


Property 要素の構文は技術的には可能ですが、推奨されません。Property element syntax is technically possible, but not recommended. インラインスタイルとテンプレート」を参照してください。See Inline Styles and Templates. TemplateBindingまたは Binding を使用したバインディング参照も可能ですが、一般的ではありません。A binding reference using TemplateBinding or Binding is also possible, but uncommon.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field StyleProperty
メタデータプロパティが true に設定されるMetadata properties set to true AffectsMeasure