コンボコントロールの基本的な構成について解説します。
コンボコントロールは以下の要素から構成されています。
リストから選択された項目や入力したテキストを表示し、画像とテキストを表示することができます。表示する項目や内容は、TextFormat プロパティで自由に設定することが可能です。またテキストボックスは、テキストコントロールと同様、Format プロパティにより入力文字種を限定することができます。
テキストボックス部の利用方法については、「テキストボックスの使い方」で詳しく解説します。
コンボコントロールが保持する項目を表示する領域です。複数の列を表示することができ、また任意の列に画像を表示したり、項目ごとに異なるスタイルで表示したりすることも可能です。リストボックス部の利用方法については、「リストボックスの使い方」を参照してください。また、項目を設定する方法については、「項目の設定」を参照してください。
項目のタイトルとしてコントロールの最上部に表示され、カラムの表示幅の変更や項目のソートに利用することができます。ヘッダは、ヘッダ全体の設定を行うヘッダ領域と、各カラムで個別の設定を行うカラムヘッダで構成されます。ヘッダの詳細については、「ヘッダの設定」を参照してください。
コントロールの最下部に表示され、テキストを表示することができます。詳細は本ページの「ステータスバー」で解説しています。
全カラムの幅の合計がコントロールよりも大きい場合や、リストの項目が多い場合等、水平と垂直方向にスクロールバーを表示できます。 スクロールバーの表示について、以下のプロパティで制御できます。
コントロールに値を入力するには、ドロップダウンリストから項目を選択するか、テキストボックス部分に直接編集する方法があります。 DropDownStyle プロパティを使用して、コンボコントロールのテキストボックスでの編集を可能にするかどうかを設定します。 既定値はComboBoxStyle.DropDown です。
プロパティの値 | 説明 |
---|---|
Simple | テキスト部分は編集できます。リスト部分は常に表示されます。 |
DropDown | テキスト部分は編集できます。リスト部分を表示するには、矢印ボタンをクリックします。 |
DropDownList | ユーザーはテキスト部分を直接編集できません。リスト部分を表示するには、矢印ボタンをクリックします。 |
StatusBar プロパティを使うと、リストボックスの最下部にステータスバーを表示できます。 StatusBar プロパティは、StatusBar クラスを参照し、StatusBar クラスのVisible プロパティをTrueにするとステータスバーが表示されます。 また、初期状態ではStatusBar クラスのText プロパティに割り当てられた文字列がステータスバーに表示されます。マウスカーソルが項目の上にあるときには、ListDescriptionSubItemIndex プロパティで指定されているカラムの内容が表示されます。
また、ListDescriptionFormat プロパティを使用すると、カラムの内容に任意の文字列を組み合わせることができます。 ListDescriptionFormat プロパティが設定されているとき、StatusBar クラスのText プロパティの設定は無効になります。
なお、ListDescriptionFormat プロパティに設定する書式はTextFormat プロパティへ設定するものと同じです。
次のサンプルコードは、ステータスバーに0番目のカラムの内容と文字列を表示するよう、ListDescriptionFormat プロパティを設定する例です。
GcComboBox1.ListDescriptionFormat = "[0]を選択します。"
gcComboBox1.ListDescriptionFormat = "[0]を選択します。";