目次に戻る
一覧ページに戻る
CPCheckBox::SetHintText
2001/12/18 update.
ツールヒントの文字列を指定します。

書式

  void SetHintText(char *lpStr);

パラメータ


lpStr
ツールヒントの文字列を指定します。最大510バイト分まで指定可能です。
複数行表示の場合の改行は、「\n」で行ってください(Macintosh環境でも同じです)。

解説


ツールヒントの文字列を指定します。
ツールヒントを無効にする場合は、引数の文字列にカラ文字("")を指定してください。





ウィンドウ(ダイアログ)を生成して、その中にチェックボックスを配置します。
以下では、「TestDialog」というキャプションのダイアログ内に「CheckBox」とついたチェックボックスを配置しています。
このチェックボックスにマウスカーソルを合わせると、「CheckBoxのツールヒントです。」と書かれたツールヒントが表示されます。

CPWindow win;
CPCheckBox chkbox;

//ダイアログを生成する
win.Clear();
win.CreateNewDialog("TestDialog",120,120,300,200);

//チェックボックスの位置・サイズを指定
chkbox.SetBounds(10,10,120,14);

//チェックボックスの文字列を指定
chkbox.SetText("CheckBox");

//ツールヒントの文字列を指定
chkbox.SetHintText("CheckBoxのツールヒントです。");

//ツールヒントのフォントサイズを指定
chkbox.SetHintFontSize(10);

//ツールヒントの文字色を指定
chkbox.SetHintForegroundColor(CP_RGB(0,0,255));

//ツールヒントの背景色を指定
chkbox.SetHintBackgroundColor(CP_RGB(192,255,192));

//チェックボックスをCPWindowに結びつける
win.Add(&chkbox);

//ダイアログの表示・イベントループの開始
win.DoModal();

この結果、チェックボックスにカーソルを合わせると、以下のようなツールヒントが表示されます。




ビルド時に必要なファイル


ライブラリ :CPartsLib.lib (Macintoshの場合は、CPartsCW.a)
ヘッダ :CPCheckBox.h


関連リンク


CPCheckBoxクラス
CPCheckBox::SetHintFontSize
CPCheckBox::SetHintForegroundColor
CPCheckBox::SetHintBackgroundColor