データ項目の一覧を表示するコントロールを表します。
オブジェクト モデル
シンタックス
'宣言 Public Class GcListBox Inherits System.Windows.Controls.ItemsControl
public class GcListBox : System.Windows.Controls.ItemsControl
解説
GcListBoxはSystem.Windows.Controls.ItemsControlです。つまり、任意のタイプのオブジェクト（文字列、画像、パネルなど）のコレクションを含めることができます。 詳細については、System.Windows.Controls.ItemsControlクラスを参照してください。
UseMultipleColumnプロパティで指定されるGcListBoxにデータ項目を表示する2つのモードがあります。
UseMultipleColumnをtrueに設定すると、GcListBoxはカスタマイズ可能なグリッドにデータを表示します。
デフォルトでは、System.Windows.Controls.ItemsControl.ItemsSourceまたはSystem.Windows.Controls.ItemsControl.Itemsプロパティを設定すると、GcListBoxコントロールが列を自動的に生成します。 生成された列は、連結されたboolプロパティの場合はListCheckBoxColumn型、連結されたImageSourceプロパティの場合はListImageColumn型、その他すべてのプロパティの場合はListTextColumn型です。
列を生成するかどうかに関係なく、Columnsコレクションを使用して、実行時にコントロール内の列をプログラムで追加、挿入、削除、および変更できます。 または、XAMLで列を指定することもできます。その場合は、AutoGenerateColumnsをfalseに設定する必要があります。 独自の列を作成すると、ListTemplateColumn型やカスタム列タイプなどの追加の列型を使用できます。 ListTemplateColumn型は、単純なカスタム列を作成する簡単な方法を提供します。 ListTemplateColumn.SubItemTemplateプロパティを使用すると、表示するコンテンツテンプレートを指定できます。
ListItemをSystem.Windows.Controls.ItemsControl.ItemsまたはSystem.Windows.Controls.ItemsControl.ItemsSourceに設定した場合、ListItem.SubItemsでカスタマイズされたSubItemを表示するには、ListSubItemColumnを作成する必要があります。
この現在のモードでは、System.Windows.Controls.ItemsControlから継承された一部のプロパティ（System.Windows.Controls.ItemsControl.ItemTemplate、System.Windows.Controls.ItemsControl.DisplayMemberPath、System.Windows.Controls.ItemsControl.ItemsPanelなど）は有効になりません。
UseMultipleColumnをfalseに設定すると、GcListBoxはSystem.Windows.Controls.ItemsControlのデフォルト表示でデータ項目を表示します。
GcListBoxは、設定されたアイテムデータのアイテムコンテナとしてListItemBaseが生成されます。 ListItemをアイテムデータとして定義すると、ListItem.SubItemsの最初のSubItemの ListItem.Content または SubItem.Content SubItem が、生成されたListItemBaseにラップされて表示されます。
この現在のモードでは、System.Windows.Controls.ItemsControlから継承された一部のプロパティ（System.Windows.Controls.ItemsControl.ItemsPanelなど）は有効になりません。
対応している System.Windows.VisualState リスト:
|
VisualStateGroup 名 |
VisualState 名 |
説明 |
|---|---|---|
|
CommonStates |
Normal |
コントロールが通常の状態にあるときの外観を表します。 |
|
CommonStates |
Disabled |
System.Windows.UIElement.IsEnabled が falseのときの外観を表します。 |
|
ActiveStates |
Active |
IsActive が trueのときの外観を表します。 |
|
ActiveStates |
Inactive |
IsActive が falseのときの外観を表します。 |
|
ValidationStates |
Valid |
System.Windows.Controls.Validation.GetHasError(System.Windows.DependencyObject) が falseを返すときの外観を表します。 |
|
ValidationStates |
InvalidFocused |
System.Windows.Controls.Validation.GetHasError(System.Windows.DependencyObject)がtrueを返し、コントロールにフォーカスがある場合の外観を表します。 |
|
ValidationStates |
InvalidUnfocused |
System.Windows.Controls.Validation.GetHasError(System.Windows.DependencyObject)がtrueを返し、コントロールにフォーカスがない場合の外観を表します。 |
継承階層
System.Object
System.Windows.Threading.DispatcherObject
System.Windows.DependencyObject
System.Windows.Media.Visual
System.Windows.UIElement
System.Windows.FrameworkElement
System.Windows.Controls.Control
System.Windows.Controls.ItemsControl
GrapeCity.Wpf.SpreadSheet.CellType.Editors.GcListBox
参照