Registers a tool with the ToolTip control
#include <GuiToolTip.au3>
_GUIToolTip_AddTool ( $hTool, $hWnd, $sText [, $iID = 0 [, $iLeft = 0 [, $iTop = 0 [, $iRight = 0 [, $iBottom = 0 [, $iFlags = Default [, $iParam = 0]]]]]]] )
| $hTool | Handle to the ToolTip control (returned by _GUIToolTip_Create.) |
| $hWnd | Handle of the window that contains the tool, or 0 |
| $sText | Text for the ToolTip control. See remark. |
| $iID | [optional] Identifier of the tool, or Window handle of the control the tool is to be assigned to |
| $iLeft | [optional] X coordinate of the upper left corner of the rectangle |
| $iTop | [optional] Y coordinate of the upper left corner of the rectangle |
| $iRight | [optional] X coordinate of the lower right corner of the rectangle |
| $iBottom | [optional] Y coordinate of the lower right corner of the rectangle |
| $iFlags | [optional] Flags that control the ToolTip display: $TTF_IDISHWND - Indicates that $iID is a window or control handle, instead of the ID of the tool $TTF_CENTERTIP - Centers the tooltip below the control specified by $iID $TTF_RTLREADING - Indicates that text will be displayed in the opposite direction of the parent window (see remarks) $TTF_SUBCLASS - Indicates that the control should subclass the tool's window $TTF_TRACK - Positions the tooltip window next to the tool to which it corresponds $TTF_ABSOLUTE - Positions the window at the same coordinates provided by TTM_TRACKPOSITION. (see remarks) $TTF_TRANSPARENT- Causes the control to forward mouse messages to the parent window $TTF_PARSELINKS - Indicates that links in the control text should be displayed as links Default = BitOr($TTF_SUBCLASS, $TTF_IDISHWND) |
| $iParam | [optional] Application-defined value that is associated with the tool |
| Success: | True. |
| Failure: | False. |
If a notification callback is needed, you have to set $sText = -1 (LPSTR_TEXTCALLBACK).
If you use the flag $TTF_IDISHWND then the coordinates in $iLeft, $iTop, $iRight and $iBottom are ignored.
If you use the flag $TTF_ABSOLUTE it must be used with the $TTF_TRACK flag.
Normal windows display text left-to-right (LTR). Windows can be mirrored to display languages such as Hebrew or Arabic that read right-to-left (RTL). Normally, tooltip text is displayed in the same direction as the text in its parent window. If $TTF_RTLREADING is set, tooltip text will read in the opposite direction from the text in the parent window.
#include <GUIConstantsEx.au3>
#include <GUIToolTip.au3>
Example()
Func Example()
Local $hGUI = GUICreate(StringTrimRight(@ScriptName, StringLen(".exe")), 350, 200)
Local $idButton = GUICtrlCreateButton("This is a button", 30, 32, 130, 28)
Local $hButton = GUICtrlGetHandle($idButton)
; create a tooltip control using default settings
Local $hToolTip = _GUIToolTip_Create(0)
; add a tool to the tooltip control
_GUIToolTip_AddTool($hToolTip, 0, "This is a ToolTip", $hButton)
GUISetState(@SW_SHOW)
While 1
If GUIGetMsg() = $GUI_EVENT_CLOSE Then ExitLoop
WEnd
; Destroy the tooltip control
_GUIToolTip_Destroy($hToolTip)
GUIDelete($hGUI)
EndFunc ;==>Example
#include <GUIConstantsEx.au3>
#include <GUIToolTip.au3>
#include <StaticConstants.au3>
; This example demonstrates how to add a tool, it does not assign the tool to any control, just an area of the GUI
Example()
Func Example()
Local $hGUI = GUICreate(StringTrimRight(@ScriptName, StringLen(".exe")), 350, 200)
; create frames to indicate where the tooltip will display when the mouse is in the
; correct location on the GUI, these frames do not have a tooltip assigned to it
; these frames are ONLY for visual representation as to where the tooltip will display,
; they are not needed to make the tooltip display.
GUICtrlCreateLabel("", 10, 10, 160, 75, $SS_ETCHEDFRAME)
; this label control must be disabled or the tooltip will not display when the mouse
; is over it.
GUICtrlSetState(-1, $GUI_DISABLE)
GUICtrlCreateLabel("", 10, 84, 160, 75, $SS_ETCHEDFRAME)
; this label control must be disabled or the tooltip will not display when the mouse
; is over it.
GUICtrlSetState(-1, $GUI_DISABLE)
GUICtrlCreateLabel("", 169, 10, 160, 75, $SS_ETCHEDFRAME)
; this label control must be disabled or the tooltip will not display when the mouse
; is over it.
GUICtrlSetState(-1, $GUI_DISABLE)
GUICtrlCreateLabel("", 169, 84, 160, 75, $SS_ETCHEDFRAME)
; this label control must be disabled or the tooltip will not display when the mouse
; is over it.
GUICtrlSetState(-1, $GUI_DISABLE)
Local $idButton = GUICtrlCreateButton("This is a button", 30, 32, 130, 28)
Local $hButton = GUICtrlGetHandle($idButton)
; create a tooltip control using default settings
Local $hToolTip = _GUIToolTip_Create(0)
; add 4 tools to the tooltip control, these tools are created using the location on the GUI
; rather than assigning them to a specific control.
_GUIToolTip_AddTool($hToolTip, $hGUI, "Upper Left corner", 0, 10, 10, 168, 85, $TTF_SUBCLASS)
_GUIToolTip_AddTool($hToolTip, $hGUI, "Upper Right corner", 0, 168, 10, 328, 85, $TTF_SUBCLASS)
_GUIToolTip_AddTool($hToolTip, $hGUI, "Lower Left corner", 0, 10, 85, 168, 160, $TTF_SUBCLASS)
_GUIToolTip_AddTool($hToolTip, $hGUI, "Lower Right corner", 0, 168, 85, 328, 160, $TTF_SUBCLASS)
; add a tool to the tooltip control that is assigned to the button control
_GUIToolTip_AddTool($hToolTip, 0, "This tooltip belongs to the button", $hButton)
GUISetState(@SW_SHOW)
While 1
If GUIGetMsg() = $GUI_EVENT_CLOSE Then ExitLoop
WEnd
; Destroy the tooltip control
_GUIToolTip_Destroy($hToolTip)
GUIDelete($hGUI)
EndFunc ;==>Example