CComboBox::SetCueBanner
コンボ ボックス コントロールに表示されるキューのテキストを設定します。
BOOL SetCueBanner(
LPCTSTR lpszText
);
パラメーター
パラメーター |
説明 |
|---|---|
[入力] lpszText |
キューのテキストを含む null で終わるバッファーへのポインター。 |
戻り値
このメソッドが成功した場合は true。それ以外の場合は false。
解説
キューのテキストは、コンボ ボックス コントロールの入力領域に表示されるプロンプトです。キューのテキストは、ユーザーが入力を提供するまで表示されます。
このメソッドは Windows SDKで説明する CB_SETCUEBANNER のメッセージを送信します。
必要条件
ヘッダー: afxwin.h
このメソッドは、Windows Vista およびそれ以降のバージョンでサポートされています。
このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。
使用例
次のコード例は、プログラムによってコンボ ボックス コントロールへのアクセスに使用される変数、m_comboboxを定義します。この変数は次のように使用されます。
// Variable to access the combo box control
CComboBox m_combobox;
次のコード例は、コンボ ボックス コントロールのキューの見出しを設定します。
// Add extra initialization here.
// Add 20 items to the combo box. The Resource Editor
// has already been used to set the style of the combo
// box to CBS_SORT.
CString str;
for (int i = 1; i <= 20; i++)
{
str.Format(_T("Item %2d"), i);
m_combobox.AddString(str);
}
// Set the minimum visible item
m_combobox.SetMinVisibleItems( 10 );
// Set the cue banner
m_combobox.SetCueBanner(_T("Select an item..."));
// End of extra initialization.