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

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

値 意味
TTF_ABSOLUTE
 ツールヒント ウィンドウを、 TTM_TRACKPOSITIONが提供するのと同じ座標に配置します。 このフラグは、TTF_TRACK フラグと共に使用する必要があります。
TTF_CENTERTIP
 uId メンバーによって指定されたツールの下にツールヒント ウィンドウを中央に移動します。
TTF_IDISHWND
 uId メンバーがツールのウィンドウ ハンドルであることを示します。 このフラグが設定されていない場合、 uId はツールの識別子です。
TTF_PARSELINKS

バージョン 6.0 以降。 ツールヒント テキスト内のリンクを解析する必要があることを示します。

Comctl32.dll バージョン 6 は再頒布可能ではありませんが、Windows 以降に含まれていることに注意してください。 バージョン 6 Comctl32.dll 使用するには、マニフェストで指定します。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。
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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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