Function Reference


_GUIToolTip_GetMaxTipWidth

Retrieves the maximum width of a ToolTip window

#include <GuiToolTip.au3>
_GUIToolTip_GetMaxTipWidth ( $hWnd )

Parameters

$hWnd Handle to the ToolTip control (returned by _GUIToolTip_Create.)

Return Value

Success: the maximum ToolTip width, in pixels.
Failure: -1.

Remarks

The maximum ToolTip width value does not indicate a ToolTip window's actual width.
Rather, if a ToolTip string exceeds the maximum width, the control breaks the text into multiple lines, using spaces to determine line breaks.
If the text cannot be segmented into multiple lines, it will be displayed on a single line.
The length of this line may exceed the maximum ToolTip width.

Related

_GUIToolTip_SetMaxTipWidth

Example

#include <GUIConstantsEx.au3>
#include <GUIToolTip.au3>

Example()

Func Example()
        Local $hGUI = GUICreate("ToolTip Get/Set Max TipWidth (v" & @AutoItVersion & ")", 350, 200)

        Local $idButton = GUICtrlCreateButton("Button ToolTip", 30, 32, 130, 28)
        Local $hButton = GUICtrlGetHandle($idButton)

        ; Create a ToolTip control
        Local $hToolTip = _GUIToolTip_Create($hGUI)
        ; Set the maximum width to 400 pixels
        _GUIToolTip_SetMaxTipWidth($hToolTip, 400)
        ; Add a multi-line tool to the ToolTip control using @CRLF to break the text into 2 lines
        _GUIToolTip_AddTool($hToolTip, 0, 'If the text exceeds the width, then it carries over to the next line.' & @CRLF & 'Also allows you to use @CRLF', $hButton)
        ; Add a multi-line tool to the ToolTip control using the MaxTipWidth setting to break the text into 2 lines.
        _GUIToolTip_AddTool($hToolTip, 0, 'If the text exceeds the width, then it carries over to the next line. Also allows you to use @CRLF', $hGUI)
        GUISetState(@SW_SHOW)

        While 1
                If GUIGetMsg() = $GUI_EVENT_CLOSE Then ExitLoop
        WEnd
        ; Destroy the ToolTip control
        _GUIToolTip_Destroy($hToolTip)
        GUIDelete($hGUI)
EndFunc   ;==>Example