GrapeCity InputMan for Windows Forms 11.0J
構成要素

コンボコントロールの基本的な構成について解説します。

各部の名称と機能

コンボコントロールは以下の要素から構成されています。


テキストボックス

リストから選択された項目や入力したテキストを表示し、画像とテキストを表示することができます。表示する項目や内容は、TextFormat プロパティで自由に設定することが可能です。またテキストボックスは、テキストコントロールと同様、Format プロパティにより入力文字種を限定することができます。
テキストボックス部の利用方法については、「テキストボックスの使い方」で詳しく解説します。

リストボックス

コンボコントロールが保持する項目を表示する領域です。複数の列を表示することができ、また任意の列に画像を表示したり、項目ごとに異なるスタイルで表示したりすることも可能です。リストボックス部の利用方法については、「リストボックスの使い方」を参照してください。また、項目を設定する方法については、「項目の設定」を参照してください。

ヘッダ

項目のタイトルとしてコントロールの最上部に表示され、カラムの表示幅の変更や項目のソートに利用することができます。ヘッダは、ヘッダ全体の設定を行うヘッダ領域と、各カラムで個別の設定を行うカラムヘッダで構成されます。ヘッダの詳細については、「ヘッダの設定」を参照してください。

ステータスバー

コントロールの最下部に表示され、テキストを表示することができます。詳細は本ページの「ステータスバー」で解説しています。

スクロールバー

全カラムの幅の合計がコントロールよりも大きい場合や、リストの項目が多い場合等、水平と垂直方向にスクロールバーを表示できます。 スクロールバーの表示について、以下のプロパティで制御できます。

値の入力

コントロールに値を入力するには、ドロップダウンリストから項目を選択するか、テキストボックス部分に直接編集する方法があります。 DropDownStyle プロパティを使用して、コンボコントロールのテキストボックスでの編集を可能にするかどうかを設定します。 既定値はComboBoxStyle.DropDown です。

プロパティの値 説明
Simple テキスト部分は編集できます。リスト部分は常に表示されます。
DropDown テキスト部分は編集できます。リスト部分を表示するには、矢印ボタンをクリックします。
DropDownList ユーザーはテキスト部分を直接編集できません。リスト部分を表示するには、矢印ボタンをクリックします。

DropDownStyleがSimple、もしくはDropDownの場合、IsEditableプロパティを使用して、テキスト部分の直接編集を可能にするかどうかを設定します。IsEditableにfalseを設定した場合、テキストの編集はできませんが、テキストの選択やコピーは可能です。既定値はtrue(編集可)です。

ステータスバー

StatusBar プロパティを使うと、リストボックスの最下部にステータスバーを表示できます。 StatusBar プロパティは、StatusBar クラスを参照し、StatusBar クラスのVisible プロパティをTrueにするとステータスバーが表示されます。 また、初期状態ではStatusBar クラスのText プロパティに割り当てられた文字列がステータスバーに表示されます。マウスカーソルが項目の上にあるときには、ListDescriptionSubItemIndex プロパティで指定されているカラムの内容が表示されます。

また、ListDescriptionFormat プロパティを使用すると、カラムの内容に任意の文字列を組み合わせることができます。 ListDescriptionFormat プロパティが設定されているとき、StatusBar クラスのText プロパティの設定は無効になります。

なお、ListDescriptionFormat プロパティに設定する書式はTextFormat プロパティへ設定するものの他、Instanceキーワードを用いて設定を行います。

次のサンプルコードは、ステータスバーに0番目のカラムの内容と文字列、項目の総数を表示するよう、ListDescriptionFormat プロパティを設定する例です。

GcComboBox1.ListDescriptionFormat = "[0]を選択します。 項目数:[instance.Items.Count]件"
gcComboBox1.ListDescriptionFormat = "[0]を選択します。 項目数:[instance.Items.Count]件";

関連トピック

 

 


© 2004 GrapeCity inc. All rights reserved.