Sets the maximum width for a ToolTip window
#include <GuiToolTip.au3>
_GUIToolTip_SetMaxTipWidth ( $hWnd, $iWidth )
$hWnd | Handle to the ToolTip control (returned by _GUIToolTip_Create.) |
$iWidth | Maximum ToolTip window width to be set (in pixels) |
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.
A ToolTip control needs this setting if you want to have a multi-line ToolTip. Without this setting, if you put a line break (@CR, @LF, @CRLF) in the text of a tool, the text will be truncated at that line break.
#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