TOOLINFO

The TOOLINFO structure contains information about a tool in a tooltip control.

typedef struct { // ti

UINT cbSize;

UINT uFlags;

HWND hwnd;

UINT uId;

RECT rect;

HINSTANCE hinst;

LPTSTR lpszText;

} TOOLINFO, NEAR *PTOOLINFO, FAR *LPTOOLINFO;

Members

cbSize

Size, in bytes, of the TOOLINFO structure. This member must be specified.

uFlags

A set of bit flags. This member can be a combination of the following values:

Value Meaning
TTF_IDISHWND Indicates that the uId member is the window handle to the tool. If this flag is not set, uId is the identifier of the tool.
TTF_CENTERTIP Centers the tooltip window below the tool specified by the uId member.
TTF_RTLREADING Displays text using right-to-left reading order on Hebrew or Arabic systems.
TTF_SUBCLASS Indicates that the tooltip control should subclass the tool's window to intercept messages, such as WM_MOUSEMOVE. If not set, you need to use the TTM_RELAYEVENT message to forward messages to the tooltip control. For a list of messages that a tooltip control processes, see TTM_RELAYEVENT.

hwnd

Handle to the window that contains the tool. If lpszText includes the LPSTR_TEXTCALLBACK value, this member identifies the window that receives TTN_NEEDTEXT notification messages.

uId

Application-defined identifier of the tool. If uFlags includes the TTF_IDISHWND value, uId must specify the window handle to the tool.

rect

Coordinates of the bounding rectangle of the tool. The coordinates are relative to the upper-left corner of the client area of the window identified by hwnd. If uFlags includes the TTF_IDISHWND value, this member is ignored.

hinst

Handle to the instance that contains the string resource for the tool. If lpszText specifies the identifier of a string resource, this member is used.

lpszText

Pointer to the buffer that contains the text for the tool, or identifier of the string resource that contains the text. If this member is set to the LPSTR_TEXTCALLBACK value, the control sends the TTN_NEEDTEXT notification message to the owner window to retrieve the text.

See Also

TTN_NEEDTEXT