バージョン

テーマの使用

デフォルトのテーマに加え、すべての Ultimate UI for WPF コントロールにカスタム テーマが提供されます。このトピックは、WPF アプリケーションのすべてのコントロールまたは個別にカスタム テーマを適用する方法を説明します。

使用可能なテーマ

Ultimate UI for WPF コントロール スイートには 4 つのテーマが含まれます。

  • Office 2010 Blue テーマ - Ultimate UI for WPF コントロールは、新しいカラフルな外観を作成できます。このスタイルは、Microsoft Office® 2010 アプリケーション スイートのインターフェイスをモデルにしています。

  • Office 2013 テーマ - MS Office 2013 のルック アンド フィール。

  • Royal Dark テーマ - 視覚状態が追加された統一感のあるシンプルなテーマで UX を向上する暗い色のテーマです。

  • Royal Light テーマ - 視覚状態が追加された統一感のあるシンプルなテーマで UX を向上する明るい色のテーマです。

  • IG テーマ - 黒、白、強調表示とアクセント カラーとして青、およびいくつかのグレーを使用したモノクロ。

  • Metro テーマ - タッチ フレンドリーのテーマです。白、グレー、黒色を使用しています。このコントロールは、簡単に使用できるようにタッチ領域が大きくなっています。

  • Metro ダーク テーマ - タッチ フレンドリーのテーマです。ダークグレー、青色、黒色を使用しています。このコントロールは、簡単に使用できるようにタッチ領域が大きくなっています。

テーマの実装

インフラジスティックス テーマは、物理的なファイルのセットにラップされたリソース ディクショナリです。すべてのコントロールには、外部ファイルとして出荷される固有の Office 2010 Blue テーマ、IG テーマ、および Metro テーマのリソースファイルがあります。各リソース ディクショナリには、Ultimate UI for WPF コントロールのすべてのコンポーネントをターゲットとするスタイルのコレクションが含まれます。(xamMap コントロールの MapNavigationPane 要素など)。XAML とコード ビハインドの両方でテーマ リソースを操作できます。

テーマの場所

Ultimate UI for WPF 製品のインストールが成功すると、Windows のスタート メニューが変更され、項目のグループが含まれます。「Themes」という名前のフォルダーとハードドライブ上のテーマ リソース ファイルの場所にナビゲートする「テーマ フォルダーを開く」のショートカットリンクがあります。

C:\Program Files (x86)\Infragistics\2023.2\WPF\Themes

現在、Office 2010 Blue テーマ、IG テーマ、および Metro テーマパックが提供されており、テーマのリソース ファイルが対応するフォルダにそれぞれ置かれています。

テーマ リソース ディクショナリ ファイル名は以下の通りです。

テーマ名 テーマ リソース ファイルの命名規則

Office 2010 Blue テーマ

Office2010Blue.[コントロール名].xaml

Office 2013 テーマ

Office2013.[コントロール名].xaml

Royal Dark テーマ

RoyalDark.[コントロール名].xaml

Royal Light テーマ

RoyalLight.[コントロール名].xaml

IG テーマ

IG.[コントロール名].xaml

Metro テーマ

Metro.[コントロール名].xaml

Metro ダーク テーマ

MetroDark.[コントロール名].xaml

テーマの適用

この例は、Metro テーマを xamRadialGauge コントロールに適用する方法を示します。ただし、同じ手順に従って、Ultimate UI for WPF 製品のその他のコントロールにテーマを適用することができます。 同様に、IG または Office 2010 Blue テーマを xamRadialGauge またはその他のコントロールに適用できます。

Note
注:

注: 以下の例は、プロジェクトで xamRadialGauge コントロールのためにアセンブリ参照をすでに追加したことが前提となっています。アプリケーションの xamRadialGauge コントロールで以前設定したスタイルおよび外観プロパティがある場合に、明示的または暗示的に削除する必要があります。そうでない場合、Metro テーマは正しく適用されません。

  1. プロジェクトに新しいフォルダーを追加して Themes という名前をつけます。

  2. 以下の場所から IG Theme フォルダーを Themes フォルダーにドラッグ アンド ドロップします。これで、Metro テーマのすべてのテーマ リソース ファイルがプロジェクトに追加されますが、アプリケーションで使用されないリソース ディクショナリを削除できます。

Note
注:

注: テーマ リソース ファイルと同じフォルダーにコピーする 3 つの共有ファイルがあります - Theme.Colors.xaml、Styles.Shared.xaml、および Styles.WPF.xaml。このファイルはコントロールのテーマに参照される可能性があります。

C:\Program Files (x86)\Infragistics\2023.2\WPF\Themes

Note
注:

: テーマ リソース ファイルは、Content または Resource としてプロジェクトに組み込むことができます。これは Visual Studio – Build Action プロパティの FileProperties ウィンドウで指定されます。

  • テーマのリソース ファイルが Content として組み込まれる場合、それはアプリケーション パッケージに含まれ、テーマ フォルダーへの相対パスを設定する必要があります。

  • テーマ リソース ファイルが Resource としてアプリケーション アセンブリに組み込まれる場合、Source プロパティはアプリケーションのアセンブリ名を前に付ける必要があります。

以下の表は、テーマ リソース ファイルを組み込むために選択されたさまざまなビルド アクションに基づいたソース パスの例を示します。

ビルド アクション テーマ リソース ファイルのソース パス

ページ

/Themes/MetroTheme/Metro.xamGauges.xaml

リソース

/AppAssemblyName;component/Themes/MetroTheme/Metro.xamGauges.xaml

Note
注:

注: Application レベルでコントロールのテーマ リソース ファイルを結合してプロジェクトのコントロールのすべてのインスタンスにテーマを適用できます。または Page、Window または Control レベルで結合して、プロジェクトのコントロールの単一のインスタンスにテーマを適用できます。

  1. アプリケーションに xamRadialGauge コントロールの Metro テーマを適用します。

XAML の場合:

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/Themes/MetroTheme/Metro.xamGauges.xaml"/>
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

Visual Basic の場合:

Dim resource As New ResourceDictionary()
resource.Source = New Uri("/Themes/MetroTheme/Metro.xamGauges.xaml", UriKind.Relative)
Application.Current.Resources.MergedDictionaries.Add(resource)

C# の場合:

ResourceDictionary resource = new ResourceDictionary();
resource.Source = new Uri("/Themes/MetroTheme/Metro.xamGauges.xaml", UriKind.Relative);
Application.Current.Resources.MergedDictionaries.Add(resource);
  1. プロジェクトを保存して実行します。以下の画像は、Metro テーマが適用された xamRadialGauge コントロールを示しています。

Designers Guide Using Themes 01.png

複合コントロールでテーマを適用

xamGeographicMap コントロールは複合コントロールです。テーマを適用するには、アプリケーションおよび MergedDictionaries コレクションに以下のファイルを含める必要があります。

  • [テーマ名].xamGeographicMap.xaml

  • [テーマ名].DataVisualization.xaml

XAML の場合:

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/Themes/IgTheme/IG.DataVisualization.xaml"/>
            <ResourceDictionary Source="/Themes/IgTheme/IG.xamGeographicMap.xaml"/>
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

xamDataChart コントロールもまた複合コントロールです。以下のテーマ リソースファイルをアプリケーションに含み結合する必要があります。

  • [テーマ名].xamDataChart.xaml

  • [テーマ名].DataVisualization.xaml

XAML の場合:

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/Themes/IgTheme/IG.DataVisualization.xaml"/>
            <ResourceDictionary Source="/Themes/IgTheme/IG.xamDataChart.xaml"/>
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>