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 以降で実行されているプログラムでのみ使用できます。

ツールヒントの有効化の詳細については、「派生していない CFrameWndWindows のツール ヒント」を参照してください。

使用の詳細については、「コントロールと使用CToolTipCtrl」を参照CToolTipCtrlしてください。

継承階層

CObject

CCmdTarget

CWnd

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は NULLnIDTool 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の動作を実装します。

現在のツールヒント コントロールを最後のマウス メッセージの座標に表示します。

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。

関連項目

CWnd クラス
階層図
CToolBar クラス