TTTOOLINFOA 構造体 (commctrl.h)
TOOLINFO 構造体には、ツールに関する情報がツール ヒント コントロールに含まれています。
構文
typedef struct tagTOOLINFOA {
UINT cbSize;
UINT uFlags;
HWND hwnd;
UINT_PTR uId;
RECT rect;
HINSTANCE hinst;
LPSTR lpszText;
LPARAM lParam;
void *lpReserved;
} TTTOOLINFOA, *PTOOLINFOA, *LPTTTOOLINFOA;
メンバー
cbSize
型: UINT
この構造体のサイズ (バイト単位)。 このメンバーを指定する必要があります。
uFlags
型: UINT
ヒントの表示を制御するフラグ。 このメンバーには、次の値の組み合わせを指定できます。
値 | 意味 |
---|---|
|
ツールヒント ウィンドウを、 TTM_TRACKPOSITIONが提供するのと同じ座標に配置します。 このフラグは、TTF_TRACK フラグと共に使用する必要があります。 |
|
uId メンバーによって指定されたツールの下にツールヒント ウィンドウを中央に移動します。 |
|
uId メンバーがツールのウィンドウ ハンドルであることを示します。 このフラグが設定されていない場合、 uId はツールの識別子です。 |
|
バージョン 6.0 以降。 ツールヒント テキスト内のリンクを解析する必要があることを示します。 Comctl32.dll バージョン 6 は再頒布可能ではありませんが、Windows 以降に含まれていることに注意してください。 バージョン 6 Comctl32.dll 使用するには、マニフェストで指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。 |
|
ヒントテキストが親ウィンドウのテキストとは反対の方向に表示されることを示します。 |
|
ツールヒント コントロールが、 WM_MOUSEMOVEなどのメッセージをインターセプトするためにツールのウィンドウをサブクラス化する必要があることを示します。 このフラグが設定されていない場合は、 TTM_RELAYEVENT メッセージを使用して、ツールヒント コントロールにメッセージを転送する必要があります。 ツールヒント コントロールで処理されるメッセージの一覧については、「TTM_RELAYEVENT」を参照してください。 |
|
ツールに対応するツールの横にツールヒント ウィンドウを配置し、 TTM_TRACKPOSITION メッセージによって指定された座標に従ってウィンドウを移動します。 TTM_TRACKACTIVATE メッセージを使用して、この種類のツールをアクティブにする必要があります。 |
|
ヒント コントロールにマウス イベント メッセージを親ウィンドウに転送させます。 これは、ツールヒント ウィンドウの境界内で発生するマウス イベントに限定されます。 |
hwnd
種類: HWND
ツールを含むウィンドウを処理します。 lpszText にLPSTR_TEXTCALLBACK値が含まれている場合、このメンバーは、TTN_GETDISPINFO通知コードを受け取るウィンドウを識別します。
uId
種類: UINT_PTR
ツールのアプリケーション定義識別子。 uFlags に TTF_IDISHWND フラグが含まれている場合、uId はツールへのウィンドウ ハンドルを指定する必要があります。
rect
種類: RECT
ツールの外接する四角形の座標。 座標は、 hwnd で識別されるウィンドウのクライアント領域の左上隅を基準にしています。 uFlags に TTF_IDISHWND フラグが含まれている場合、このメンバーは無視されます。
hinst
種類: HINSTANCE
ツールの文字列リソースを含むインスタンスを処理します。 lpszText が文字列リソースの識別子を指定する場合、このメンバーが使用されます。
lpszText
種類: LPTSTR
ツールのテキストを含むバッファーへのポインター、またはテキストを含む文字列リソースの識別子。 このメンバーは、値を返すために使用される場合があります。 返された値を調べる必要がある場合は、十分なサイズの有効なバッファーを指す必要があります。 それ以外の場合は、 NULL に設定できます。 lpszText が LPSTR_TEXTCALLBACK に設定されている場合、コントロールはTTN_GETDISPINFO通知コードを所有者ウィンドウに送信してテキストを取得します。
lParam
型: LPARAM
バージョン 4.70 以降。 ツールに関連付けられている 32 ビットのアプリケーション定義値。
lpReserved
型: void*
予約済み。 NULL に設定する必要があります。
注釈
通常のウィンドウには、左から右 (LTR) のテキストが表示されます。 Windows を ミラーリング して、右から左 (RTL) を読み取るヘブライ語やアラビア語などの言語を表示できます。 通常、ヒントテキストは、親ウィンドウのテキストと同じ方向に表示されます。 TTF_RTLREADINGが設定されている場合、ヒントテキストは親ウィンドウのテキストとは逆方向に読み取られます。
注意
commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして TTTOOLINFO を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
Header | commctrl.h |