TTTOOLINFOW 構造体 (commctrl.h)

[アーティクル]
11/18/2024

TOOLINFO 構造体には、ツールヒントコントロール内のツールに関する情報が含まれています。

構文

typedef struct tagTOOLINFOW {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPWSTR    lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOW, *PTOOLINFOW, *LPTTTOOLINFOW;

メンバーズ

cbSize

型: UINT

この構造体のサイズ (バイト単位)。このメンバーを指定する必要があります。

uFlags

型: UINT

ヒントの表示を制御するフラグ。このメンバーには、次の値を組み合わせて使用できます。

価値	意味
TTF_ABSOLUTE	ツールヒントウィンドウを、TTM_TRACKPOSITIONによって提供されるのと同じ座標に配置します。このフラグは、TTF_TRACK フラグと共に使用する必要があります。
TTF_CENTERTIP	uId メンバーによって指定されたツールの下にツールヒントウィンドウ中央に移動します。
TTF_IDISHWND	uId メンバーがツールのウィンドウハンドルであることを示します。このフラグが設定されていない場合、uId はツールの識別子です。
TTF_PARSELINKS	バージョン 6.0 以降。ツールヒントテキスト内のリンクを解析する必要があることを示します。 Comctl32.dll バージョン 6 は再頒布可能ではありませんが、Windows 以降に含まれていることに注意してください。バージョン 6 Comctl32.dll 使用するには、マニフェストで指定します。マニフェストの詳細については、「Visual Stylesを有効にする」を参照してください。
TTF_RTLREADING	ヒントテキストが親ウィンドウのテキストとは反対の方向に表示されることを示します。
TTF_SUBCLASS	ツールヒントコントロールが、WM_MOUSEMOVEなどのメッセージをインターセプトするためにツールのウィンドウをサブクラス化する必要があることを示します。このフラグが設定されていない場合は、TTM_RELAYEVENT メッセージを使用して、ヒントコントロールにメッセージを転送する必要があります。ツールヒントコントロールが処理するメッセージの一覧については、「TTM_RELAYEVENT」を参照してください。
TTF_TRACK	ツールに対応するツールの横にツールヒントウィンドウを配置し、TTM_TRACKPOSITION メッセージによって指定された座標に従ってウィンドウを移動します。 TTM_TRACKACTIVATE メッセージを使用して、この種類のツールをアクティブにする必要があります。
TTF_TRANSPARENT	ヒントコントロールがマウスイベントメッセージを親ウィンドウに転送します。これは、ツールヒントウィンドウの境界内で発生するマウスイベントに限定されます。

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 を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリのみ]
ヘッダー	commctrl.h

次の方法で共有

TTTOOLINFOW 構造体 (commctrl.h)

構文

メンバーズ

備考

必要条件

フィードバック

その他のリソース