SPREAD for WPF 3.0J - GcSpreadGrid
名前付きスタイル
GrapeCity SPREAD for WPF 3.0J > 開発者ガイド > 外観 > 名前付きスタイル

スタイルを表す StyleInfo クラスを使用してコントロールの外観およびフォーカス取得の可否やロックといった機能を設定できます。コントロールは次の図のように、コーナーヘッダ、列ヘッダ、行ヘッダ、コンテンツの4つの領域で構成されています。各領域の要素にスタイルを設定できます。

スタイル

ここで言う「スタイル」は本製品における外観の設定を表します。WPF の「スタイル」や「テンプレート」ではありません。

名前付きスタイル

コントロールの各要素に名前でスタイルを設定できます。名前の付けられたスタイルを「名前付きスタイル」と呼びます。コントロールで名前付きスタイルを使用するには、コントロールの NamedStyleInfos プロパティで名前付きスタイルのコレクションを参照し Add メソッドで追加します。

サンプルコード

次のサンプルコードはコントロールに名前付きスタイルを追加し、1列目に設定します。

C#
コードのコピー
StyleInfo s = new StyleInfo() { Background = new SolidColorBrush(Colors.Orange)};
gcSpreadGrid1.NamedStyleInfos.Add("MyOrangeStyle", s);
gcSpreadGrid1.Columns[0].StyleName = "MyOrangeStyle";
Visual Basic
コードのコピー
Dim s As New StyleInfo() With {.Background = New SolidColorBrush(Colors.Orange)}
GcSpreadGrid1.NamedStyleInfos.Add("MyOrangeStyle", s)
GcSpreadGrid1.Columns(0).StyleName = "MyOrangeStyle"

各領域のスタイル

コントロールの各領域で設定できるスタイルについて説明します。

コンテンツのスタイル

コンテンツでスタイルを設定できる要素は次のとおりです。

要素 名前付きスタイルの設定 名前付きスタイル以外の設定
セル StyleName プロパティ 各種プロパティ
(例)Background
新規行 NewRowStyleName プロパティ NewRowStyle プロパティ
StyleName プロパティ 各種プロパティ
(例)Background
グループ ヘッダ/フッタ セル StyleName プロパティ 各種プロパティ
(例)Background
グループ ヘッダ/フッタ 行 StyleName プロパティ 各種プロパティ
(例)Background
グループ ヘッダ/フッタ StyleName プロパティ Style プロパティ
StyleName プロパティ 各種プロパティ
(例)Background
交互行 StyleName プロパティ 各種プロパティ
(例)Background
コンテンツ全体 DefaultStyleName プロパティ DefaultStyle プロパティ

列ヘッダのスタイル

列ヘッダでスタイルを設定できる要素は次のとおりです。

要素 名前付きスタイルの設定 名前付きスタイル以外の設定
セル StyleName プロパティ 各種プロパティ
(例)Background
StyleName プロパティ 各種プロパティ
(例)Background
StyleName プロパティ 各種プロパティ
(例)Background
交互行 StyleName プロパティ 各種プロパティ
(例)Background
列ヘッダ全体 DefaultStyleName プロパティ DefaultStyle プロパティ

コーナー ヘッダのスタイル

コーナー ヘッダでスタイルを設定できる要素は次のとおりです。

要素 名前付きスタイルの設定 名前付きスタイル以外の設定
セル StyleName プロパティ 各種プロパティ
(例)Background
StyleName プロパティ 各種プロパティ
(例)Background
StyleName プロパティ 各種プロパティ
(例)Background
交互行 StyleName プロパティ 各種プロパティ
(例)Background
コーナー ヘッダ全体 DefaultStyleName プロパティ DefaultStyle プロパティ

行ヘッダのスタイル

行ヘッダでスタイルを設定できる要素は次のとおりです。

要素 名前付きスタイルの設定 名前付きスタイル以外の設定
セル StyleName プロパティ 各種プロパティ
(例)Background
新規行 NewRowStyleName プロパティ NewRowStyle プロパティ
StyleName プロパティ 各種プロパティ
(例)Background
グループ ヘッダ/フッタ セル StyleName プロパティ 各種プロパティ
(例)Background
グループ ヘッダ/フッタ 行 StyleName プロパティ 各種プロパティ
(例)Background
グループ ヘッダ/フッタ StyleName プロパティ Style プロパティ
StyleName プロパティ 各種プロパティ
(例)Background
交互行 StyleName プロパティ 各種プロパティ
(例)Background
行ヘッダ全体 DefaultStyleName プロパティ DefaultStyle プロパティ

設定の継承と優先度

セルは行や列に対して設定されたスタイルを継承します。ただし、セルに対する設定が最優先されます。セル、行、列に異なるスタイルが設定された場合、セルに対する設定が有効となります。

設定の確認

セルの InheritedStyle プロパティで実際にセルで有効なスタイルを確認できます。セル、行、列に異なるスタイルが設定された場合、最終的にセルで有効な設定を取得できます。

関連トピック