Funktionsreferenz

GUICtrlSetTip

Legt den "Tip-Text" eines Controls fest.

GUICtrlSetTip ( controlID, tiptext [, "title" [, icon [, options]]]]] )

 

Parameter

ControlID Die Identifikationsnummer des Controls (Control-ID), wie von einer GUICtrlCreate... Funktion zurückgegeben.
tiptext Tip-Text, der angezeigt wird, wenn die Maus einige Zeit auf dem Control steht.
title [optional] Der Titel für den Tooltip Benötigt IE5+
icon [optional] Vordefiniertes Icon, welches neben dem Titel angezeigt werden soll: Benötigt IE5+. Benötigt einen Titel.
0 = Kein Icon, 1 = Info-Icon, 2 = Warn-Icon, 3 = Fehler-Icon
options [optional] Setzt die verschiedenen Optionen, wie der Tooltip dargestellt werden soll (kann addiert werden):
1 = Darstellung als Balloon-Tipp Benötigt IE5+
2 = Zentriert den Tipp horizontal entlang des Controls.

 

Rückgabewert

Erfolg: Gibt 1 zurück.
Fehler: Gibt 0 zurück.

 

Bemerkungen

Dieser Tipp-Text wird in einem rechteckigen Tooltip-Feld dargestellt.
Um einen optionalen Parameter zu überspringen, also bei seinem Standardwert zu belassen, ist das Schlüsselwort "Default" zu verwenden.
Für mehrzeilige Tooltips können @CR oder @LF verwendet werden.
Die Titel-, Icon- und Balloon- Tip-Option benötigt jeweils den Internet Explorer 5.0 oder neuer, um zu funktionieren.
Um ein Icon darzustellen, muss ein "nicht leerer" Titel definiert werden. Das Icon erscheint in der selben Zeile wie der Titel, deshalb muss auch ein Titel vorhanden sein.

- - - - - - - - Erklärung der Controls - - - - - - - -

 

Verwandte Funktionen

GUICtrlUpdate...

 

Beispiel


#include <GUIConstantsEx.au3>

Opt('MustDeclareVars', 1)

Example()

Func Example()
    Local $msg

    GUICreate("Meine GUI mit dem Hinweis-Control") ; Erstellt ein GUI-Fenster welches mittig ausgerichtet wird

    GUICtrlCreateLabel("mein Label", 10, 20)
    GUICtrlSetTip(-1, "Hinweis meines Labels")

    GUISetState()

    ; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst
    While 1
        $msg = GUIGetMsg()

        If $msg = $GUI_EVENT_CLOSE Then ExitLoop
    WEnd
EndFunc   ;==>Example