ツール ヒント コントロールにツールを登録します。
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 を返します。
解説
lpRectTool と nIDTool の両方のパラメーターが有効である必要があります。または lpRectTool が NULL である場合、nIDTool は 0 である必要があります。
ツール ヒント コントロールは 1 つ以上のツールに結び付けることができます。 この関数では、ツールをツール ヒント コントロールに登録し、カーソルがツールの上に置かれたときに、ツール ヒントに格納されている情報を表示できるようにします。
注意
AddTool を使ってツール ヒントをスタティック コントロールに設定することはできません。
使用例
CPropertySheet::GetTabControl の例を参照してください。
必要条件
**ヘッダー:**afxcmn.h