システムリソースの使用方法

2025-05-07

この例では、システム定義リソースを使用する方法を示します。システムリソースは WPF によって提供され、フォント、色、アイコンなどのオペレーティングシステムリソースにアクセスできます。システムリソースは、Windows と一貫性のあるビジュアルを作成するのに役立つ、いくつかのシステム定義値をリソースとプロパティの両方として公開します。

フォント

オペレーティングシステムで使用されるフォントを参照するには、 SystemFonts クラスを使用します。このクラスには、静的プロパティとしてシステムフォント値と、実行時にこれらの値に動的にアクセスするために使用できるリソースキーを参照するプロパティが含まれています。たとえば、CaptionFontFamily は SystemFonts 値であり、CaptionFontFamilyKey は対応するリソースキーです。

次の例は、テキストブロックのスタイルを設定またはカスタマイズするために、静的な値として SystemFonts のプロパティにアクセスして使用する方法を示しています。

<TextBlock FontSize="{x:Static SystemFonts.SmallCaptionFontSize}"
           FontWeight="{x:Static SystemFonts.SmallCaptionFontWeight}"
           FontFamily="{x:Static SystemFonts.SmallCaptionFontFamily}"
           Text="Small Caption Font">
</TextBlock>

コードで SystemFonts の値を使用するには、静的な値または動的リソース参照を使用する必要はありません。代わりに、SystemFonts クラスのキー以外のプロパティを使用します。キー以外のプロパティは明らかに静的プロパティとして定義されていますが、システムによってホストされる WPF の実行時動作では、プロパティがリアルタイムで再評価され、システム値に対するユーザー主導の変更が適切に考慮されます。次の例は、ボタンのフォント設定を指定する方法を示しています。

var myButton = new Button()
{
    Content = "SystemFonts",
    Background = SystemColors.ControlDarkDarkBrush,
    FontSize = SystemFonts.IconFontSize,
    FontWeight = SystemFonts.MessageFontWeight,
    FontFamily = SystemFonts.CaptionFontFamily
};

mainStackPanel.Children.Add(myButton);

Dim myButton = New Button() With
{
    .Content = "SystemFonts",
    .Background = SystemColors.ControlDarkDarkBrush,
    .FontSize = SystemFonts.IconFontSize,
    .FontWeight = SystemFonts.MessageFontWeight,
    .FontFamily = SystemFonts.CaptionFontFamily
}

mainStackPanel.Children.Add(myButton)

XAML での動的フォント

システムフォントメトリックは、静的リソースまたは動的リソースとして使用できます。アプリケーションの実行中にフォントメトリックを自動的に更新する場合は、動的リソースを使用します。それ以外の場合は、静的リソースを使用します。

注

動的リソースには、プロパティ名にキーワード Key が追加されています。

次の例は、システムフォントの動的リソースにアクセスして使用して、テキストブロックのスタイルを設定またはカスタマイズする方法を示しています。

<TextBlock FontSize="{DynamicResource {x:Static SystemFonts.SmallCaptionFontSize}}"
           FontWeight="{DynamicResource {x:Static SystemFonts.SmallCaptionFontWeight}}"
           FontFamily="{DynamicResource {x:Static SystemFonts.SmallCaptionFontFamily}}"
           Text="Small Caption Font">
</TextBlock>

パラメーター

SystemParameters クラスを使用して、プライマリディスプレイのサイズなどのシステムレベルのプロパティを参照します。このクラスには、システムパラメーター値のプロパティと、値にバインドするリソースキーの両方が含まれています。たとえば、 FullPrimaryScreenHeight は SystemParameters プロパティ値であり、 FullPrimaryScreenHeightKey は対応するリソースキーです。

次の例は、 SystemParameters の静的な値にアクセスして使用して、ボタンのスタイルを設定またはカスタマイズする方法を示しています。このマークアップの例では、ボタンに SystemParameters 値を適用して、ボタンのサイズを変更します。

<Button FontSize="8" 
        Height="{x:Static SystemParameters.CaptionHeight}"
        Width="{x:Static SystemParameters.IconGridWidth}"
        Content="System Parameters">
</Button>

コードで SystemParameters の値を使用するには、静的参照または動的リソース参照を使用する必要はありません。代わりに、 SystemParameters クラスの値を使用します。キー以外のプロパティは明らかに静的プロパティとして定義されていますが、システムによってホストされる WPF の実行時の動作では、プロパティがリアルタイムで再評価され、システム値に対するユーザー主導の変更が適切に考慮されます。次の例は、 SystemParameters 値を使用してボタンの幅と高さを設定する方法を示しています。

var myButton = new Button()
{
    Content = "SystemParameters",
    FontSize = 8,
    Background = SystemColors.ControlDarkDarkBrush,
    Height = SystemParameters.CaptionHeight,
    Width = SystemParameters.CaptionWidth,
};

mainStackPanel.Children.Add(myButton);

Dim myButton = New Button() With
{
    .Content = "SystemParameters",
    .FontSize = 8,
    .Background = SystemColors.ControlDarkDarkBrush,
    .Height = SystemParameters.CaptionHeight,
    .Width = SystemParameters.CaptionWidth
}

mainStackPanel.Children.Add(myButton)

XAML の動的パラメーター

システムパラメーターメトリックは、静的リソースまたは動的リソースとして使用できます。アプリケーションの実行中にパラメーターメトリックを自動的に更新する場合は、動的リソースを使用します。それ以外の場合は、静的リソースを使用します。

注

動的リソースには、プロパティ名にキーワード Key が追加されています。

次の例は、システムパラメーターの動的リソースにアクセスして使用して、ボタンのスタイルを設定またはカスタマイズする方法を示しています。この XAML の例では、ボタンの幅と高さに SystemParameters 値を割り当てることで、ボタンのサイズを変更します。

<Button FontSize="8" 
        Height="{DynamicResource {x:Static SystemParameters.CaptionHeightKey}}"
        Width="{DynamicResource {x:Static SystemParameters.IconGridWidthKey}}"
        Content="System Parameters">
</Button>

次の方法で共有

システム リソースの使用方法

フォント

XAML での動的フォント

パラメーター

XAML の動的パラメーター

こちらも参照ください

その他のリソース

システムリソースの使用方法