Functions > GUI > GUICtrlUpdate >


GUICtrlSetTip

Définit le texte de l'info-bulle associée à un contrôle.

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

Paramètres

controlID L'identifiant du contrôle tel que retourné par une fonction GUICtrlCreate...(), ou -1 pour désigner le dernier contrôle créé.
tiptext Texte de la bulle qui s'affiche lorsque la souris survole le contrôle.
title [optionnel] Le titre de l'info-bulle
icon [optionnel] Icône pré-définie pour l'afficher à côté du titre: nécessite un titre.
     $TIP_NOICON (0) = Pas d'icône
     $TIP_INFOICON (1) = Icône Info
     $TIP_WARNINGICON (2) = Icône Warning
     $TIP_ERRORICON (3) = Icône Error

Les constantes sont définies dans "AutoItConstants.au3".
options [optionnel] Définit différentes options pour la façon dont l'info-bulle s'affiche (elles peuvent s'ajouter):
     $TIP_BALLOON (1) = S'affiche comme Info-bulle Balloon.
     $TIP_CENTER (2) = Centre l'Info-bulle horizontalement le long du contrôle.

Les constantes sont définies dans "AutoItConstants.au3".

Valeur de retour

Succès: Retourne 1.
Échec: Retourne 0.

Remarques

Le texte de l'Info-bulle est affiché dans une zone rectangulaire.
Pour sauter un paramètre optionnel, laissez sa valeur par défaut intacte, utilisez le mot-clé Default.
Vous pouvez utiliser @CR ou @LF pour créer des info-bulles multi-lignes.
Pour afficher une icône, vous devez indiquer un titre non vide. L'icône apparaît sur la même ligne que le titre et nécessite donc qu'un titre soit présent.

En relation

GUICtrlUpdate...

Exemple

#include <GUIConstantsEx.au3>

Example()

Func Example()
    GUICreate("My GUI control tip") ; Crée une GUI centrée

    GUICtrlCreateLabel("my label", 10, 20)
    GUICtrlSetTip(-1, "tip of my label")

    GUISetState(@SW_SHOW)

    ; Boucle jusqu'à ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example