リストボックスのスタイル

[アーティクル]
05/12/2022

CreateWindow または CreateWindowEx 関数を使用してリストボックスを作成するには、LISTBOX クラス、適切なウィンドウスタイル定数、および次のスタイル定数を使用してリストボックスを定義します。コントロールが作成された後、これらのスタイルは、特に説明されている場合を除き、変更できません。

常時	説明
LBS_COMBOBOX	リストボックスがコンボボックスの一部であることを通知します。これにより、2 つのコントロール間の調整が可能になるため、統合 UI が表示されます。コンボボックス自体でこのスタイルを設定する必要があります。スタイルがコンボボックス以外で設定されている場合、リストボックス自体がコンボボックスの子と誤って見なされ、エラーが発生します。
LBS_DISABLENOSCROLL	リストボックスにスクロールするのに十分な項目が含まれていない場合に、無効になっている水平スクロールバーまたは垂直スクロールバーが表示されます。このスタイルを指定しない場合、リストボックスに十分な項目が含まれていない場合、スクロールバーは非表示になります。このスタイルは、 WS_VSCROLL または WS_HSCROLL スタイルで使用する必要があります。
LBS_EXTENDEDSEL	Shift キーとマウスまたは特殊なキーの組み合わせを使用して、複数の項目を選択できるようにします。
LBS_HASSTRINGS	リストボックスに文字列で構成される項目が含まれていることを指定します。リストボックスには文字列のメモリとアドレスが保持されるため、アプリケーションは LB_GETTEXT メッセージを使用して特定のアイテムのテキストを取得できます。既定では、所有者が描画したリストボックスを除くすべてのリストボックスには、このスタイルがあります。このスタイルの有無にかかわらず、所有者描画リストボックスを作成できます。このスタイルを持たない所有者描画リストボックスの場合、 LB_GETTEXT メッセージはアイテム (アイテムデータ) に関連付けられている値を取得します。
LBS_MULTICOLUMN	水平方向にスクロールする複数列のリストボックスを指定します。リストボックスでは列の幅が自動的に計算されるか、アプリケーションは LB_SETCOLUMNWIDTH メッセージを使用して幅を設定できます。リストボックスに LBS_OWNERDRAWFIXED スタイルがある場合、アプリケーションは、リストボックスが WM_MEASUREITEM メッセージを送信するときに幅を設定できます。 LBS_MULTICOLUMN スタイルのリストボックスは、受信したWM_VSCROLLメッセージを無視して垂直方向にスクロールすることはできません。 LBS_MULTICOLUMNスタイルとLBS_OWNERDRAWVARIABLEスタイルを組み合わせることはできません。両方を指定した場合、 LBS_OWNERDRAWVARIABLE は無視されます。
LBS_MULTIPLESEL	ユーザーがリストボックス内の文字列をクリックまたはダブルクリックするたびに、文字列の選択をオンまたはオフにします。ユーザーは任意の数の文字列を選択できます。
LBS_NODATA	データなしリストボックスを指定します。リストボックスの項目数が 1,000 を超える場合は、このスタイルを指定します。データなしのリストボックスには、LBS_OWNERDRAWFIXED スタイルも必要ですが、 LBS_SORT または LBS_HASSTRINGS スタイルを持つ必要はありません。データなしリストボックスは、アイテムの文字列またはビットマップデータが含まれないことを除き、所有者が描画したリストボックスに似ています。項目を追加、挿入、または削除するコマンドは、指定された項目データを常に無視します。リストボックス内の文字列を検索する要求は常に失敗します。アイテムを描画する必要があるときに、 WM_DRAWITEM メッセージが所有者ウィンドウに送信されます。 WM_DRAWITEM メッセージと共に渡される DRAWITEMSTRUCT 構造体の itemID メンバーは、描画する項目の行番号を指定します。データなしリストボックスでは、 WM_DELETEITEM メッセージは送信されません。
LBS_NOINTEGRALHEIGHT	リストボックスのサイズが、リストボックスの作成時にアプリケーションによって指定されたサイズと正確に一致することを指定します。通常、リストボックスに部分的な項目が表示されないように、リストボックスのサイズが設定されます。 LBS_OWNERDRAWVARIABLE スタイルのリストボックスの場合、LBS_NOINTEGRALHEIGHT スタイルは常に適用されます。
LBS_NOREDRAW	変更が行われたときにリストボックスの外観が更新されないことを指定します。コントロールの再描画状態を変更するには、 WM_SETREDRAW メッセージを使用します。
LBS_NOSEL	リストボックスに、表示できる項目と選択できない項目が含まれていることを指定します。
LBS_NOTIFY	ユーザーがリストボックス項目 (LBN_SELCHANGE) をクリックしたとき、アイテム (LBN_DBLCLK) をダブルクリックしたとき、または選択 (LBN_SELCANCEL) をキャンセルするたびに、リストボックスが親ウィンドウに通知コードを送信します。
LBS_OWNERDRAWFIXED	リストボックスの所有者がその内容を描画し、リストボックス内の項目の高さが同じであることを指定します。所有者ウィンドウは、リストボックスの作成時に WM_MEASUREITEM メッセージを受け取り、リストボックスの視覚的な側面が変更されたときに WM_DRAWITEM メッセージを受け取ります。
LBS_OWNERDRAWVARIABLE	リストボックスの所有者がその内容を描画し、リストボックス内の項目の高さが可変であることを指定します。所有者ウィンドウは、リストボックスの作成時にボックス内の各項目の WM_MEASUREITEM メッセージを受け取り、リストボックスの視覚的な側面が変更されたときに WM_DRAWITEM メッセージを受け取ります。このスタイルにより、 LBS_NOINTEGRALHEIGHT スタイルが有効になります。 LBS_MULTICOLUMN スタイルが指定されている場合、このスタイルは無視されます。
LBS_SORT	リストボックス内の文字列をアルファベット順に並べ替えます。
LBS_STANDARD	リストボックス内の文字列をアルファベット順に並べ替えます。親ウィンドウは、ユーザーがリストボックスアイテムをクリックしたとき、アイテムをダブルクリックしたとき、または選択を取り消すたびに通知コードを受け取ります。リストボックスには垂直スクロールバーがあり、すべての辺に罫線が付きます。このスタイルは、 LBS_NOTIFY、 LBS_SORT、 WS_VSCROLL、およびWS_BORDER のスタイルを組み合わせたものになります。
LBS_USETABSTOPS	文字列を描画するときに、リストボックスでタブ文字を認識および展開できるようにします。 LB_SETTABSTOPSメッセージを使用して、タブ位置を指定できます。既定のタブ位置は、32 個のダイアログテンプレート単位で離れています。ダイアログテンプレートユニットは、ダイアログボックステンプレートで使用されるデバイスに依存しない単位です。ダイアログテンプレート単位から画面単位 (ピクセル) に測定値を変換するには、 MapDialogRect 関数を使用します。
LBS_WANTKEYBOARDINPUT	ユーザーがキーを押し、リストボックスに入力フォーカスがあるときに常に、リストボックスの所有者が WM_VKEYTOITEM メッセージを受信することを指定します。これにより、アプリケーションはキーボード入力に対して特別な処理を実行できます。

要件

要件	値
ヘッダー	Winuser.h