FrameworkContentElement.Style プロパティ

リファレンス

定義

名前空間:: System.Windows

アセンブリ:: PresentationFramework.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

プロパティ値

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

適用対象

次の方法で共有