Win32 API 日本語リファレンス
ホームUI.Controls › TTTOOLINFOA

TTTOOLINFOA

構造体
サイズx64: 72 バイト / x86: 48 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ (バイト単位)。このメンバーは必ず指定してください。
uFlagsTOOLTIP_FLAGS4+4+4

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

意味
TTF_ABSOLUTE
TTM_TRACKPOSITION で指定された座標と同じ位置にツールヒント ウィンドウを配置します。このフラグは TTF_TRACK フラグと組み合わせて使用しなければなりません。
TTF_CENTERTIP
uId メンバーで指定されたツールの下側に、ツールヒント ウィンドウを中央揃えで配置します。
TTF_IDISHWND
uId メンバーがツールのウィンドウ ハンドルであることを示します。このフラグが設定されていない場合、uId はツールの識別子です。
TTF_PARSELINKS

バージョン 6.0 以降。ツールヒントのテキストに含まれるリンクを解析することを示します。

Comctl32.dll バージョン 6 は再頒布可能ではありませんが、Windows 以降に含まれています。Comctl32.dll バージョン 6 を使用するには、マニフェストで指定します。マニフェストの詳細については、ビジュアル スタイルの有効化を参照してください。

TTF_RTLREADING
ツールヒントのテキストを、親ウィンドウのテキストとは逆方向に表示することを示します。
TTF_SUBCLASS
ツールヒント コントロールがツールのウィンドウをサブクラス化し、WM_MOUSEMOVE などのメッセージを横取りすることを示します。このフラグが設定されていない場合は、TTM_RELAYEVENT メッセージを使用してツールヒント コントロールにメッセージを転送する必要があります。ツールヒント コントロールが処理するメッセージの一覧については、TTM_RELAYEVENT を参照してください。
TTF_TRACK
対応するツールの隣にツールヒント ウィンドウを配置し、TTM_TRACKPOSITION メッセージで指定された座標に従ってウィンドウを移動します。この種類のツールは、TTM_TRACKACTIVATE メッセージを使用してアクティブにする必要があります。
TTF_TRANSPARENT
ツールヒント コントロールがマウス イベント メッセージを親ウィンドウに転送するようにします。転送されるのは、ツールヒント ウィンドウの範囲内で発生したマウス イベントに限られます。
hwndHWND8/4+8+8ツールを含むウィンドウへのハンドルです。lpszText に LPSTR_TEXTCALLBACK 値が指定されている場合、このメンバーは TTN_GETDISPINFO 通知コードを受け取るウィンドウを示します。
uIdUINT_PTR8/4+16+12ツールのアプリケーション定義の識別子です。uFlagsTTF_IDISHWND フラグが含まれる場合、uId にはツールのウィンドウ ハンドルを指定しなければなりません。
rectRECT16+24+16ツールの外接する四角形の座標です。座標は、hwnd で示されるウィンドウのクライアント領域の左上隅を基準とします。uFlagsTTF_IDISHWND フラグが含まれる場合、このメンバーは無視されます。
hinstHINSTANCE8/4+40+32ツールの文字列リソースを含むインスタンスへのハンドルです。lpszText が文字列リソースの識別子を指定している場合に、このメンバーが使用されます。
lpszTextLPSTR8/4+48+36ツールのテキストを格納するバッファーへのポインター、またはテキストを格納する文字列リソースの識別子です。このメンバーは値を返すために使用されることもあります。返された値を調べる必要がある場合は、十分なサイズの有効なバッファーを指していなければなりません。それ以外の場合は NULL に設定できます。lpszText に LPSTR_TEXTCALLBACK を設定すると、コントロールはテキストを取得するために TTN_GETDISPINFO 通知コードを所有者ウィンドウに送信します。
lParamLPARAM8/4+56+40バージョン 4.70 以降。ツールに関連付けられる、アプリケーション定義の 32 ビット値です。
lpReservedvoid*8/4+64+44予約済みです。NULL を設定しなければなりません。

公式ドキュメント

TOOLINFO 構造体は、ツールヒント コントロール内のツールに関する情報を保持します。

解説(Remarks)

通常のウィンドウは、テキストを左から右 (LTR) に表示します。ヘブライ語やアラビア語のように右から左 (RTL) に読む言語を表示するために、ウィンドウをミラー化することができます。通常、ツールヒントのテキストは親ウィンドウのテキストと同じ方向に表示されます。TTF_RTLREADING が設定されている場合、ツールヒントのテキストは親ウィンドウのテキストとは逆方向に表示されます。

メモ

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして TTTOOLINFO を定義しています。エンコーディングに依存しないエイリアスと、エンコーディングに依存するコードを混在させると、不一致が生じてコンパイル エラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// RECT  (x64 16 / x86 16 バイト)
typedef struct RECT {
    INT left;
    INT top;
    INT right;
    INT bottom;
} RECT;

// TTTOOLINFOA  (x64 72 / x86 48 バイト)
typedef struct TTTOOLINFOA {
    DWORD cbSize;
    TOOLTIP_FLAGS uFlags;
    HWND hwnd;
    UINT_PTR uId;
    RECT rect;
    HINSTANCE hinst;
    LPSTR lpszText;
    LPARAM lParam;
    void* lpReserved;
} TTTOOLINFOA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RECT
{
    public int left;
    public int top;
    public int right;
    public int bottom;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TTTOOLINFOA
{
    public uint cbSize;
    public uint uFlags;
    public IntPtr hwnd;
    public UIntPtr uId;
    public RECT rect;
    public IntPtr hinst;
    public IntPtr lpszText;
    public IntPtr lParam;
    public IntPtr lpReserved;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RECT
    Public left As Integer
    Public top As Integer
    Public right As Integer
    Public bottom As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TTTOOLINFOA
    Public cbSize As UInteger
    Public uFlags As UInteger
    Public hwnd As IntPtr
    Public uId As UIntPtr
    Public rect As RECT
    Public hinst As IntPtr
    Public lpszText As IntPtr
    Public lParam As IntPtr
    Public lpReserved As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class RECT(ctypes.Structure):
    _fields_ = [
        ("left", ctypes.c_int),
        ("top", ctypes.c_int),
        ("right", ctypes.c_int),
        ("bottom", ctypes.c_int),
    ]

class TTTOOLINFOA(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("uFlags", wintypes.DWORD),
        ("hwnd", ctypes.c_void_p),
        ("uId", ctypes.c_size_t),
        ("rect", RECT),
        ("hinst", ctypes.c_void_p),
        ("lpszText", ctypes.c_void_p),
        ("lParam", ctypes.c_ssize_t),
        ("lpReserved", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C)]
pub struct TTTOOLINFOA {
    pub cbSize: u32,
    pub uFlags: u32,
    pub hwnd: *mut core::ffi::c_void,
    pub uId: usize,
    pub rect: RECT,
    pub hinst: *mut core::ffi::c_void,
    pub lpszText: *mut core::ffi::c_void,
    pub lParam: isize,
    pub lpReserved: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type RECT struct {
	left int32
	top int32
	right int32
	bottom int32
}

type TTTOOLINFOA struct {
	cbSize uint32
	uFlags uint32
	hwnd uintptr
	uId uintptr
	rect RECT
	hinst uintptr
	lpszText uintptr
	lParam uintptr
	lpReserved uintptr
}
type
  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  TTTOOLINFOA = record
    cbSize: DWORD;
    uFlags: DWORD;
    hwnd: Pointer;
    uId: NativeUInt;
    rect: RECT;
    hinst: Pointer;
    lpszText: Pointer;
    lParam: NativeInt;
    lpReserved: Pointer;
  end;
const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const TTTOOLINFOA = extern struct {
    cbSize: u32,
    uFlags: u32,
    hwnd: ?*anyopaque,
    uId: usize,
    rect: RECT,
    hinst: ?*anyopaque,
    lpszText: ?*anyopaque,
    lParam: isize,
    lpReserved: ?*anyopaque,
};
type
  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  TTTOOLINFOA {.bycopy.} = object
    cbSize: uint32
    uFlags: uint32
    hwnd: pointer
    uId: uint
    rect: RECT
    hinst: pointer
    lpszText: pointer
    lParam: int
    lpReserved: pointer
struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

struct TTTOOLINFOA
{
    uint cbSize;
    uint uFlags;
    void* hwnd;
    size_t uId;
    RECT rect;
    void* hinst;
    void* lpszText;
    ptrdiff_t lParam;
    void* lpReserved;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; TTTOOLINFOA サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; uFlags : TOOLTIP_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hwnd : HWND (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; uId : UINT_PTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; rect : RECT (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; hinst : HINSTANCE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; lpszText : LPSTR (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lParam : LPARAM (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; lpReserved : void* (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; TTTOOLINFOA サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; uFlags : TOOLTIP_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hwnd : HWND (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; uId : UINT_PTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; rect : RECT (+24, 16byte)  varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; hinst : HINSTANCE (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; lpszText : LPSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; lParam : LPARAM (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; lpReserved : void* (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global TTTOOLINFOA
    #field int cbSize
    #field int uFlags
    #field intptr hwnd
    #field intptr uId
    #field RECT rect
    #field intptr hinst
    #field intptr lpszText
    #field intptr lParam
    #field intptr lpReserved
#endstruct

stdim st, TTTOOLINFOA        ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize