テキストボックスと、ユーザーが一覧から項目を選択できるリストボックスを含むドロップダウンを組み合わせた選択コントロールを表します。
オブジェクト モデル
シンタックス
'宣言 Public Class GcComboBox Inherits ControlBase
public class GcComboBox : ControlBase
解説
選択された項目がない場合は、テキストボックスには現在の選択が表示されるか、または空になります。
コンボボックスにSystem.Windows.UIElementから継承するアイテムを入力すると、選択したアイテムはビジュアルツリーに一度だけ表示されます。 つまり、選択されているアイテムは、アイテムのドロップダウンリストではなく、選択ボックスに表示されます。 アイテムが選択されない場合、ドロップダウンリストに再表示されます。 アイテムがSystem.Windows.UIElementから継承しない場合、選択ボックスとドロップダウンリストの両方に同時に表示される可能性があります。
UseMultipleColumnプロパティで指定されたGcComboBoxドロップダウンウィンドウにデータ項目を表示するには、2つのモードがあります。
列とアイテム
UseMultipleColumnをtrueに設定すると、GcComboBoxはカスタマイズ可能なグリッドにデータを表示します。デフォルトでは、ItemsSourceまたはItemsプロパティを設定すると、GcComboBoxコントロールが列を自動的に生成します。 生成された列は、連結されたItemsSourceプロパティの場合はGcComboBox型、連結されたListCheckBoxColumnプロパティの場合はItems型、その他すべてのプロパティの場合はbool型です。
列を生成するかどうかに関係なく、Columnsコレクションを使用して、実行時にコントロール内の列をプログラムで追加、挿入、削除、および変更できます。 または、XAMLで列を指定することもできます。その場合は、AutoGenerateColumnsをfalseに設定する必要があります。 独自の列を作成すると、ListTemplateColumn型やカスタム列タイプなどの追加の列タイプを使用できます。 ListTemplateColumn型は、単純なカスタム列を作成する簡単な方法を提供します。 ListTemplateColumn.SubItemTemplateプロパティを使用すると、表示するコンテンツテンプレートを指定できます。
ListItemをItemsまたはItemsSourceに設定した場合、ListItem.SubItemsでカスタマイズされたSubItemを表示するには、ListSubItemColumnを作成する必要があります。
UseMultipleColumnをfalseに設定すると、GcComboBoxはデフォルトの表示でデータ項目を表示します。
GcComboBoxは、設定されたアイテムデータのアイテムコンテナとしてListItemBaseを生成します。 ListItem をアイテムデータとして定義すると、ListItem.SubItemsの最初のSubItemの ListItem.Content または SubItem.Content が、生成された ListItemBase にラップされて表示されます。
SelectedItemプロパティを使用してコンボボックスの選択されたアイテムを取得するか、SelectedIndexプロパティを使用して選択されたアイテムのインデックスを取得できます。
GcComboBoxコントロールのカスタマイズ
ItemContainerStyleプロパティを設定することで、GcComboBoxに表示される各アイテムにスタイルを適用できます。同じプロパティ設定を複数のGcComboBoxコントロールに適用するには、Styleプロパティを使用します。 GcComboBoxの視覚的構造と視覚的動作を変更するには、デフォルトのスタイルとテンプレートをコピーして変更します。
このコントロールの依存関係プロパティは、コントロールのデフォルトスタイルによって設定される場合があります。 GcComboBoxの依存関係プロパティがデフォルトのスタイルで設定されている場合、GcComboBoxがアプリケーションに表示されると、プロパティがデフォルト値から変更される可能性があります。
Supported System.Windows.VisualState list:
|
VisualStateGroup 名 |
VisualState 名 |
説明ei |
|---|---|---|
|
CommonStates |
Normal |
コントロールが通常の状態にあるときの外観を表します。 |
|
CommonStates |
Disabled |
System.Windows.UIElement.IsEnabled が falseのときの外観を表します。 |
|
CommonStates |
MouseOver |
IsActive が trueのときの外観を表します。 |
|
ActiveStates |
ActiveDropDown |
IsActiveとIsDropDownOpenがtrueの場合の外観を表します。 |
|
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
GrapeCity.Wpf.SpreadSheet.CellType.Editors.ControlBase
GrapeCity.Wpf.SpreadSheet.CellType.Editors.GcComboBox
参照