FrameworkElement.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。既定で構築された FrameworkElement の既定値は null です。

例

次の例では、リソースディクショナリのスタイルを定義します。

<Page.Resources>

<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>

<Border Style="{StaticResource PageBackground}">

</Border>

注釈

コントロールの場合、現在のスタイルは、多くの場合、コントロールテーマから、またはページまたはアプリケーションレベル (暗黙的なスタイル) でリソースによってその型のコントロールに適用されるスタイルから、既定のスタイルによって提供されます。このプロパティは既定の (テーマ) スタイルを設定または返しませんが、要素に対して動作する暗黙的なスタイルまたは明示的なスタイルを返します。暗黙的または明示的なスタイルの場合、スタイルがリソースとして指定されているか、ローカルで定義されているかは関係ありません。

スタイルの設定にはいくつかの制限があります。プロパティ全体 Style はいつでも新 Style しいプロパティにリセットでき、レイアウトの再配置が強制されます。ただし、そのスタイルが読み込まれた要素によって使用されるとすぐに、 Style シールされていると見なす必要があります。使用中のスタイルの個々のプロパティ (コレクション Setters内のプロパティなど) を変更しようとすると、例外がスローされます。マークアップで定義されているスタイルは、リソースディクショナリ (リソースの場合) から読み込まれたり、その中に含まれているページが読み込まれたりするとすぐに使用されていると見なされます (インラインスタイルの場合)。

Style は、特別な優先順位を持つ依存関係プロパティです。一般に、ローカルに設定されたスタイルは、プロパティシステムの最も高い優先順位で動作します。 Styleこの時点で null の場合、プロパティシステムの読み込み中に、その型を指定するローカルリソースまたはアプリケーションリソース内の暗黙的なスタイルがチェックされます。この手順の後もスタイルがまだ null の場合、プレゼンテーション用の動作スタイルは通常、既定の (テーマ) スタイルから取得されますが、プロパティ値では既定の Style スタイルは返されません。「依存関係プロパティの値の優先順位」または「スタイル設定とテンプレート」を参照してください。

XAML 属性の使用方法

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

XAML プロパティ要素の使用

XAML 値

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

styleResourceKey
要求されるスタイルを識別するキー。キーは、 ResourceDictionary.

注意

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

依存プロパティ情報


識別子フィールド	StyleProperty
メタデータのプロパティが次に設定されている `true`	AffectsMeasure

適用対象

次の方法で共有