CToolTipCtrl
クラス
アプリケーション内のツールの目的を説明する 1 行のテキストを表示する小さなポップアップ ウィンドウである "ツールヒント コントロール" の機能をカプセル化します。
構文
class CToolTipCtrl : public CWnd
メンバー
パブリック コンストラクター
名前 | 説明 |
---|---|
CToolTipCtrl::CToolTipCtrl |
CToolTipCtrl オブジェクトを構築します。 |
パブリック メソッド
名前 | 説明 |
---|---|
CToolTipCtrl::Activate |
ツールヒント コントロールをアクティブ化および非アクティブ化します。 |
CToolTipCtrl::AddTool |
ツールをツールヒント コントロールに登録します。 |
CToolTipCtrl::AdjustRect |
ツールヒント コントロールのテキスト表示四角形とそのウィンドウの四角形を変換します。 |
CToolTipCtrl::Create |
ツールヒント コントロールを作成し、オブジェクトに CToolTipCtrl アタッチします。 |
CToolTipCtrl::CreateEx |
指定した Windows 拡張スタイルを使用してツールヒント コントロールを作成し、オブジェクトに CToolTipCtrl アタッチします。 |
CToolTipCtrl::DelTool |
ツールヒント コントロールからツールを削除します。 |
CToolTipCtrl::GetBubbleSize |
ツールヒントのサイズを取得します。 |
CToolTipCtrl::GetCurrentTool |
現在のツールヒント コントロールに表示されるツールヒント ウィンドウのサイズ、位置、テキストなどの情報を取得します。 |
CToolTipCtrl::GetDelayTime |
ツールヒント コントロールに現在設定されている初期、ポップアップ、および再表示の期間を取得します。 |
CToolTipCtrl::GetMargin |
ヒント ウィンドウに設定されている上、左、下、および右の余白を取得します。 |
CToolTipCtrl::GetMaxTipWidth |
ヒント ウィンドウの最大幅を取得します。 |
CToolTipCtrl::GetText |
ツールヒント コントロールメインツールに含まれるテキストを取得します。 |
CToolTipCtrl::GetTipBkColor |
ヒント ウィンドウの背景色を取得します。 |
CToolTipCtrl::GetTipTextColor |
ヒント ウィンドウ内のテキストの色を取得します。 |
CToolTipCtrl::GetTitle |
現在のツールヒント コントロールのタイトルを取得します。 |
CToolTipCtrl::GetToolCount |
ツールヒント コントロールメイン含まれるツールの数を取得します。 |
CToolTipCtrl::GetToolInfo |
ツールヒント コントロールメインツールに関する情報を取得します。 |
CToolTipCtrl::HitTest |
ポイントをテストして、指定されたツールの外接する四角形内にあるかどうかを判断します。 その場合は、ツールに関する情報を取得します。 |
CToolTipCtrl::Pop |
表示されているツールヒント ウィンドウをビューから削除します。 |
CToolTipCtrl::Popup |
現在のツールヒント コントロールを最後のマウス メッセージの座標に表示します。 |
CToolTipCtrl::RelayEvent |
マウス メッセージをツールヒント コントロールに渡して処理します。 |
CToolTipCtrl::SetDelayTime |
ツールヒント コントロールの初期、ポップアップ、および再表示の期間を設定します。 |
CToolTipCtrl::SetMargin |
ツールヒント ウィンドウの上、左、下、右の余白を設定します。 |
CToolTipCtrl::SetMaxTipWidth |
ヒント ウィンドウの最大幅を設定します。 |
CToolTipCtrl::SetTipBkColor |
ヒント ウィンドウの背景色を設定します。 |
CToolTipCtrl::SetTipTextColor |
ヒント ウィンドウのテキストの色を設定します。 |
CToolTipCtrl::SetTitle |
標準のアイコンとタイトル文字列をヒントに追加します。 |
CToolTipCtrl::SetToolInfo |
ツールのツールヒントメイン含まれる情報を設定します。 |
CToolTipCtrl::SetToolRect |
ツールの新しい外接する四角形を設定します。 |
CToolTipCtrl::SetWindowTheme |
ツールヒント ウィンドウの表示スタイルを設定します。 |
CToolTipCtrl::Update |
現在のツールを強制的に再描画します。 |
CToolTipCtrl::UpdateTipText |
ツールのツールヒント テキストを設定します。 |
解説
"ツール" は、子ウィンドウやコントロールなどのウィンドウ、またはウィンドウのクライアント領域内のアプリケーション定義の四角形領域のいずれかです。 ツールヒントは、ほとんどの場合非表示になり、ユーザーがツールにカーソルを置き、約 2 分の 1 秒だけそこに残っている場合にのみ表示されます。 ツールヒントはカーソルの近くに表示され、ユーザーがマウス ボタンをクリックするか、ツールの外にカーソルを移動すると消えます。
CToolTipCtrl
には、ツールヒントの初期時間と期間、ヒント テキストを囲む余白の幅、ヒント ウィンドウ自体の幅、ヒントの背景色とテキストの色を制御する機能が用意されています。 1 つのツールヒント コントロールで、複数のツールに関する情報を提供できます。
このクラスは CToolTipCtrl
、Windows 共通ツールヒント コントロールの機能を提供します。 このコントロール (したがって CToolTipCtrl
、クラス) は、Windows 95/98 および Windows NT バージョン 3.51 以降で実行されているプログラムでのみ使用できます。
ツールヒントの有効化の詳細については、「派生していない CFrameWnd
Windows のツール ヒント」を参照してください。
使用の詳細については、「コントロールと使用CToolTipCtrl
」を参照CToolTipCtrl
してください。
継承階層
CToolTipCtrl
必要条件
ヘッダー:afxcmn.h
CToolTipCtrl::Activate
ツールヒント コントロールをアクティブ化または非アクティブ化するには、この関数を呼び出します。
void Activate(BOOL bActivate);
パラメーター
bActivate
ツールヒント コントロールをアクティブにするか非アクティブにするかを指定します。
解説
ある場合 bActivate
は TRUE
、コントロールがアクティブになります。アクティブ化されている場合 FALSE
は非アクティブ化されます。
ツールヒント コントロールがアクティブな場合、カーソルがコントロールに登録されているツール上にあると、ツールヒント情報が表示されます。非アクティブな場合、カーソルがツール上にある場合でも、ツールヒント情報は表示されません。
例
CPropertySheet::GetTabControl
の例を参照してください。
CToolTipCtrl::AddTool
ツールをツールヒント コントロールに登録します。
BOOL AddTool(
CWnd* pWnd,
UINT nIDText,
LPCRECT lpRectTool = NULL,
UINT_PTR nIDTool = 0);
BOOL AddTool(
CWnd* pWnd,
LPCTSTR lpszText = LPSTR_TEXTCALLBACK,
LPCRECT lpRectTool = NULL,
UINT_PTR nIDTool = 0);
パラメーター
pWnd
ツールを含むウィンドウへのポインター。
nIDText
ツールのテキストを含む文字列リソースの ID。
lpRectTool
ツールの RECT
外接する四角形の座標を含む構造体へのポインター。 座標は、指定されたウィンドウのクライアント領域の左上隅を基準にしています pWnd
。
nIDTool
ツールの ID。
lpszText
ツールのテキストへのポインター。 このパラメーターに値 LPSTR_TEXTCALLBACK
が含まれている場合、 TTN_NEEDTEXT
通知メッセージは、指す pWnd
ウィンドウの親に移動します。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
パラメーターとnIDTool
パラメーターのlpRectTool
両方が有効であるか、有効な場合lpRectTool
は NULL
nIDTool
0 である必要があります。
ツールヒント コントロールは、複数のツールに関連付けることができます。 この関数を呼び出してツールをツールヒント コントロールに登録し、ツールにカーソルが置いているときにヒントに格納されている情報が表示されるようにします。
Note
を使用して AddTool
、ツールヒントを静的コントロールに設定することはできません。
例
CPropertySheet::GetTabControl
の例を参照してください。
CToolTipCtrl::AdjustRect
ツールヒント コントロールのテキスト表示四角形とそのウィンドウの四角形を変換します。
BOOL AdjustRect(
LPRECT lprc,
BOOL bLarger = TRUE);
パラメーター
lprc
ツールヒント ウィンドウの RECT
四角形またはテキスト表示の四角形を保持する構造体へのポインター。
bLarger
lprc
テキスト表示の四角形を指定するために使用され、対応するウィンドウの四角形を受け取る場合TRUE
。 ウィンドウlprc
の四角形を指定するために使用され、対応するテキスト表示四角形を受け取る場合FALSE
。
戻り値
四角形が正常に調整された場合は 0 以外。それ以外の場合は 0。
解説
このメンバー関数は、ツールヒント コントロールのテキスト表示四角形をウィンドウの四角形から計算するか、指定したテキスト表示四角形を表示するために必要なツールヒント ウィンドウの四角形を計算します。
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_ADJUSTRECT
の動作を実装します。
CToolTipCtrl::Create
ツールヒント コントロールを作成し、オブジェクトに CToolTipCtrl
アタッチします。
virtual BOOL Create(CWnd* pParentWnd, DWORD dwStyle = 0);
パラメーター
pParentWnd
ツールヒント コントロールの親ウィンドウ (通常は .CDialog
次に指定 NULL
することはできません。
dwStyle
ツールヒント コントロールのスタイルを指定します。 詳細については、「解説」セクションを参照してください。
戻り値
オブジェクトが正常に作成された CToolTipCtrl
場合は 0 以外、それ以外の場合は 0。
解説
2 つの手順で作成 CToolTipCtrl
します。 まず、コンストラクターを呼び出してオブジェクトを CToolTipCtrl
構築し、呼び出 Create
してツールヒント コントロールを作成し、オブジェクトに CToolTipCtrl
アタッチします。
このパラメーターにはdwStyle
、ウィンドウ スタイルの任意の組み合わせを指定できます。 さらに、ツールヒント コントロールには、クラス固有のスタイル TTS_ALWAYSTIP
と TTS_NOPREFIX
.
スタイル | 意味 |
---|---|
TTS_ALWAYSTIP |
ツールヒント コントロールの所有者ウィンドウがアクティブか非アクティブかに関係なく、ツール上にカーソルがあるときにツールヒントを表示することを指定します。 このスタイルがない場合、ツールの所有者ウィンドウがアクティブなときにツールヒント コントロールが表示されますが、非アクティブな場合は表示されません。 |
TTS_NOPREFIX |
このスタイルにより、システムはアンパサンド (& ) 文字を文字列から削除できなくなります。 ツールヒント コントロールにスタイルがない TTS_NOPREFIX 場合、システムはアンパサンド文字を自動的に削除し、アプリケーションがメニュー項目とツールヒント コントロールのテキストの両方と同じ文字列を使用できるようにします。 |
ツールヒント コントロールには、コントロールの作成時に WS_POPUP
指定するかどうかに関係なく、スタイルと WS_EX_TOOLWINDOW
ウィンドウ スタイルがあります。
拡張ウィンドウ スタイルを使用してツールヒント コントロールを作成するには、代わりにCreate
呼び出しますCToolTipCtrl::CreateEx
。
例
CPropertySheet::GetTabControl
の例を参照してください。
CToolTipCtrl::CreateEx
コントロール (子ウィンドウ) を作成し、オブジェクトに CToolTipCtrl
関連付けます。
virtual BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwStyle = 0,
DWORD dwStyleEx = 0);
パラメーター
pParentWnd
コントロールの親であるウィンドウへのポインター。
dwStyle
ツールヒント コントロールのスタイルを指定します。 詳細については、「解説」セクションCreate
を参照してください。
dwStyleEx
作成するコントロールの拡張スタイルを指定します。 拡張 Windows スタイルの一覧については、Windows SDK の dwExStyle
パラメーター CreateWindowEx
を参照してください。
戻り値
成功した場合は 0 以外の場合は 0。
解説
Windows 拡張スタイルのCreate
前書WS_EX_
きで指定された拡張 Windows スタイルを適用する代わりに使用CreateEx
します。
CToolTipCtrl::CToolTipCtrl
CToolTipCtrl
オブジェクトを構築します。
CToolTipCtrl();
解説
オブジェクトを構築した後で呼び出す Create
必要があります。
例
// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;
CToolTipCtrl::DelTool
ツールヒント コントロールで pWnd
サポートされているツールのコレクションから、指定 nIDTool
されたツールを削除します。
void DelTool(
CWnd* pWnd,
UINT_PTR nIDTool = 0);
パラメーター
pWnd
ツールを含むウィンドウへのポインター。
nIDTool
ツールの ID。
CToolTipCtrl::GetBubbleSize
ツールヒントのサイズを取得します。
CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;
パラメーター
lpToolInfo
ツールヒント TOOLINFO
の構造へのポインター。
戻り値
ヒントのサイズ。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_GETBUBBLESIZE
の動作を実装します。
CToolTipCtrl::GetCurrentTool
現在のツールヒント コントロールによって表示されるツールヒント ウィンドウのサイズ、位置、テキストなどの情報を取得します。
BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;
パラメーター
lpToolInfo
[out]現在の TOOLINFO
ツールヒント ウィンドウに関する情報を受け取る構造体へのポインター。
戻り値
TRUE
情報が正常に取得された場合。それ以外の場合は . FALSE
解説
このメソッドは、Windows SDK で説明されているメッセージを送信 TTM_GETCURRENTTOOL
します。
例
次のコード例では、現在のツールヒント ウィンドウに関する情報を取得します。
{
//Get information about the current tooltip.
TOOLINFO tInfo = {0};
tInfo.cbSize = sizeof(TOOLINFO);
CToolBarCtrl& m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
CToolTipCtrl* m_toolTip = m_toolBarCtrl.GetToolTips();
BOOL bRet = m_toolTip->GetCurrentTool( &tInfo );
}
CToolTipCtrl::GetDelayTime
ツールヒント コントロールに現在設定されている初期、ポップアップ、および再表示の期間を取得します。
int GetDelayTime(DWORD dwDuration) const;
パラメーター
dwDuration
取得する期間の値を指定するフラグ。 このパラメーターには、次の 値のいずれかを指定できます。
TTDT_AUTOPOP
ツールの外接する四角形内でポインターが固定されている場合にメインツールヒント ウィンドウが表示される時間の長さを取得します。TTDT_INITIAL
ツールヒント ウィンドウが表示される前に、ポインターがツールの外接する四角形内で固定メイン必要がある時間の長さを取得します。TTDT_RESHOW
ポインターが 1 つのツールから別のツールに移動すると、後続のツールヒント ウィンドウが表示されるまでにかかる時間を取得します。
戻り値
指定された遅延時間 (ミリ秒単位)
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_GETDELAYTIME
の動作を実装します。
CToolTipCtrl::GetMargin
ヒント ウィンドウに設定されている上、左、下、および右の余白を取得します。
void GetMargin(LPRECT lprc) const;
パラメーター
lprc
余白情報を RECT
受け取る構造体のアドレス。 構造体の RECT
メンバーは、外接する四角形を定義しません。 このメッセージの目的上、構造体のメンバーは次のように解釈されます。
メンバー | [表記] |
---|---|
top |
上罫線とツールヒント テキストの上との間の距離 (ピクセル単位)。 |
left |
左罫線と先端テキストの左端までの距離 (ピクセル単位)。 |
bottom |
下罫線と先端テキストの下部の間の距離 (ピクセル単位)。 |
right |
右罫線と先端テキストの右端の間の距離 (ピクセル単位)。 |
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_GETMARGIN
の動作を実装します。
CToolTipCtrl::GetMaxTipWidth
ヒント ウィンドウの最大幅を取得します。
int GetMaxTipWidth() const;
戻り値
ヒント ウィンドウの最大幅。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_GETMAXTIPWIDTH
の動作を実装します。
CToolTipCtrl::GetText
ツールヒント コントロールメインツールに含まれるテキストを取得します。
void GetText(
CString& str,
CWnd* pWnd,
UINT_PTR nIDTool = 0) const;
パラメーター
str
ツールのテキストを CString
受け取るオブジェクトへの参照。
pWnd
ツールを含むウィンドウへのポインター。
nIDTool
ツールの ID。
解説
パラメーターとnIDTool
パラメーターはpWnd
、ツールを識別します。 そのツールが以前の呼び出し CToolTipCtrl::AddTool
によってツールヒント コントロールに登録されている場合は、パラメーターによって str
参照されるオブジェクトにツールのテキストが割り当てられます。
CToolTipCtrl::GetTipBkColor
ヒント ウィンドウの背景色を取得します。
COLORREF GetTipBkColor() const;
戻り値
COLORREF
背景色を表す値。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_GETTIPBKCOLOR
の動作を実装します。
CToolTipCtrl::GetTipTextColor
ヒント ウィンドウ内のテキストの色を取得します。
COLORREF GetTipTextColor() const;
戻り値
テキストの COLORREF
色を表す値。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_GETTIPTEXTCOLOR
の動作を実装します。
CToolTipCtrl::GetTitle
現在のツールヒント コントロールのタイトルを取得します。
void GetTitle(PTTGETTITLE pttgt) const;
パラメーター
pttgt
[out]ツールヒント コントロールに関する情報を含む構造体への TTGETTITLE
ポインター。 このメソッドが返されると、 pszTitle
構造体のメンバーは TTGETTITLE
タイトルのテキストを指します。
解説
このメソッドは、Windows SDK で説明されているメッセージを送信 TTM_GETTITLE
します。
CToolTipCtrl::GetToolCount
ツールヒント コントロールに登録されているツールの数を取得します。
int GetToolCount() const;
戻り値
ツールヒント コントロールに登録されているツールの数。
CToolTipCtrl::GetToolInfo
ツールヒント コントロールメインツールに関する情報を取得します。
BOOL GetToolInfo(
CToolInfo& ToolInfo,
CWnd* pWnd,
UINT_PTR nIDTool = 0) const;
パラメーター
ToolInfo
ツールのテキストを TOOLINFO
受け取るオブジェクトへの参照。
pWnd
ツールを含むウィンドウへのポインター。
nIDTool
ツールの ID。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
hwnd
ツールをTOOLINFO
識別することによってCToolInfo
参照される構造体のメンバー。uId
そのツールが前回の呼び出し AddTool
でツールヒント コントロールに登録されている場合、構造にはツールに TOOLINFO
関する情報が入力されます。
CToolTipCtrl::HitTest
ポイントをテストして、指定されたツールの外接する四角形内にあるかどうかを判断し、存在する場合はツールに関する情報を取得します。
BOOL HitTest(
CWnd* pWnd,
CPoint pt,
LPTOOLINFO lpToolInfo) const;
パラメーター
pWnd
ツールを含むウィンドウへのポインター。
pt
テストする CPoint
ポイントの座標を含むオブジェクトへのポインター。
lpToolInfo
ツールに関する情報を含む構造体への TOOLINFO
ポインター。
戻り値
ヒット テスト情報で指定された点がツールの外接する四角形内にある場合は 0 以外。それ以外の場合は 0。
解説
この関数が 0 以外の値を返す場合、指す構造体には、ポイントが存在する lpToolInfo
四角形内のツールに関する情報が入力されます。
構造体は TTHITTESTINFO
次のように定義されます。
typedef struct _TT_HITTESTINFO { // tthti
HWND hwnd; // handle of tool or window with tool
POINT pt; // client coordinates of point to test
TOOLINFO ti; // receives information about the tool
} TTHITTESTINFO, FAR * LPHITTESTINFO;
hwnd
ツールのハンドルを指定します。
pt
ポイントがツールの外接する四角形内にある場合に、ポイントの座標を指定します。
ti
ツールに関する情報。 構造の詳細については、以下を
TOOLINFO
参照してくださいCToolTipCtrl::GetToolInfo
。
CToolTipCtrl::Pop
表示されているツールヒント ウィンドウをビューから削除します。
void Pop();
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_POP
の動作を実装します。
CToolTipCtrl::Popup
現在のツールヒント コントロールを最後のマウス メッセージの座標に表示します。
void Popup();
解説
このメソッドは、Windows SDK で説明されているメッセージを送信 TTM_POPUP
します。
例
次のコード例では、ツールヒント ウィンドウを表示します。
{
// Display the most recent tooltip.
CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
CToolTipCtrl *m_toolTip = m_toolBarCtrl.GetToolTips();
m_toolTip->Popup();
}
CToolTipCtrl::RelayEvent
マウス メッセージをツールヒント コントロールに渡して処理します。
void RelayEvent(LPMSG lpMsg);
パラメーター
lpMsg
リレーする MSG
メッセージを含む構造体へのポインター。
解説
ツールヒント コントロールは、次のメッセージのみを処理します。このメッセージは次のメッセージによって RelayEvent
送信されます。
WM_LBUTTONDOWN |
WM_MOUSEMOVE |
---|---|
WM_LBUTTONUP |
WM_RBUTTONDOWN |
WM_MBUTTONDOWN |
WM_RBUTTONUP |
WM_MBUTTONUP |
例
CPropertySheet::GetTabControl
の例を参照してください。
CToolTipCtrl::SetDelayTime
ツールヒント コントロールの遅延時間を設定します。
void SetDelayTime(UINT nDelay);
void SetDelayTime(
DWORD dwDuration,
int iTime);
パラメーター
nDelay
新しい遅延時間をミリ秒単位で指定します。
dwDuration
取得する期間の値を指定するフラグ。 有効な値の説明については、以下を参照してください CToolTipCtrl::GetDelayTime
。
iTime
指定された遅延時間 (ミリ秒)。
解説
遅延時間は、ツールでカーソルを再メインしてからツールヒント ウィンドウが表示されるまでの時間です。 既定の遅延時間は 500 ミリ秒です。
CToolTipCtrl::SetMargin
ツールヒント ウィンドウの上、左、下、右の余白を設定します。
void SetMargin(LPRECT lprc);
パラメーター
lprc
設定する RECT
余白情報を含む構造体のアドレス。 構造体の RECT
メンバーは、外接する四角形を定義しません。 余白情報の説明を参照してください CToolTipCtrl::GetMargin
。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_SETMARGIN
の動作を実装します。
CToolTipCtrl::SetMaxTipWidth
ヒント ウィンドウの最大幅を設定します。
int SetMaxTipWidth(int iWidth);
パラメーター
iWidth
設定するツールヒント ウィンドウの最大幅。
戻り値
前の最大チップ幅。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_SETMAXTIPWIDTH
の動作を実装します。
CToolTipCtrl::SetTipBkColor
ヒント ウィンドウの背景色を設定します。
void SetTipBkColor(COLORREF clr);
パラメーター
clr
新しい背景色。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_SETTIPBKCOLOR
の動作を実装します。
CToolTipCtrl::SetTipTextColor
ヒント ウィンドウのテキストの色を設定します。
void SetTipTextColor(COLORREF clr);
パラメーター
clr
新しいテキストの色。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_SETTIPTEXTCOLOR
の動作を実装します。
CToolTipCtrl::SetTitle
標準のアイコンとタイトル文字列をヒントに追加します。
BOOL SetTitle(
UINT uIcon,
LPCTSTR lpstrTitle);
パラメーター
uIcon
Windows SDK をTTM_SETTITLE
参照してくださいicon
。
lpstrTitle
タイトル文字列へのポインター。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
このメンバー関数は、Windows SDK で説明されているように、Win32 メッセージ TTM_SETTITLE
の動作を実装します。
CToolTipCtrl::SetToolInfo
ツールのツールヒントメイン含まれる情報を設定します。
void SetToolInfo(LPTOOLINFO lpToolInfo);
パラメーター
lpToolInfo
設定する情報を TOOLINFO
指定する構造体へのポインター。
CToolTipCtrl::SetToolRect
ツールの新しい外接する四角形を設定します。
void SetToolRect(
CWnd* pWnd,
UINT_PTR nIDTool,
LPCRECT lpRect);
パラメーター
pWnd
ツールを含むウィンドウへのポインター。
nIDTool
ツールの ID。
lpRect
新しい外接する四角形を指定する構造体への RECT
ポインター。
CToolTipCtrl::SetWindowTheme
ツールヒント ウィンドウの表示スタイルを設定します。
HRESULT SetWindowTheme(LPCWSTR pszSubAppName);
パラメーター
pszSubAppName
設定するビジュアル スタイルを含む Unicode 文字列へのポインター。
戻り値
戻り値は使用されません。
解説
このメンバー関数は、Windows SDK で説明されているように、メッセージの TTM_SETWINDOWTHEME
機能をエミュレートします。
CToolTipCtrl::Update
現在のツールを強制的に再描画します。
void Update();
CToolTipCtrl::UpdateTipText
このコントロールのツールのツールヒント テキストを更新します。
void UpdateTipText(
LPCTSTR lpszText,
CWnd* pWnd,
UINT_PTR nIDTool = 0);
void UpdateTipText(
UINT nIDText,
CWnd* pWnd,
UINT_PTR nIDTool = 0);
パラメーター
lpszText
ツールのテキストへのポインター。
pWnd
ツールを含むウィンドウへのポインター。
nIDTool
ツールの ID。
nIDText
ツールのテキストを含む文字列リソースの ID。
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示