Prev Next

TOOLINFO info  Overview  Group

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