UDF > GUI > GuiToolTip >

_GUIToolTip_SetTitle

Ajoute une ic�ne standard et une cha�ne titre

#include <GuiToolTip.au3>
_GUIToolTip_SetTitle ( $hWnd, $sTitle [, $iIcon = 0] )

Param�tres

$hWnd Handle du contr�le info-bulle (retourn� par _GUIToolTip_Create.)
$sTitle Cha�ne titre
$iIcon [optionnel] Doit prendre l'une des valeurs ci-dessous:
    $TTI_NONE (0) - Pas d'ic�ne [par d�faut]
    $TTI_INFO (1) - Ic�ne Information
    $TTI_WARNING (2) - Ic�ne Attention
    $TTI_ERROR (3) - Ic�ne Erreur
    $TTI_INFO_LARGE (4) - Ic�ne Large Information
    $TTI_WARNING_LARGE (5) - Ic�ne large Avertissement
    $TTI_ERROR_LARGE (6) - Ic�ne large Erreur

Les constantes sont d�finies dans ToolTipConstants.au3

Valeur de retour

Succ�s: Retourne True.
�chec: Retourne False.

Remarque

Avec Windows XP SP2 et les versions ult�rieures, $iIcon peut contenir une valeur HICON. Toute valeur sup�rieure � 3 est suppos�e �tre une HICON.
Le titre d'une info-bulle appara�t au-dessus du texte, dans une police diff�rente. Il ne suffit pas d'avoir un titre; l'info-bulle doit avoir aussi un texte, sinon il ne s'affiche pas.
Un titre avec une ic�ne, mais aucun texte dans le titre n'affichera pas le titre ou l'ic�ne. Vous devez d�finir le texte du titre, m�me si c'est seulement un caract�re, si vous pr�voyez d'utiliser une ic�ne.
La cha�ne d'entr�e dans $sTitle ne doit pas d�passer 99 caract�res.

En relation

_GUIToolTip_GetTitleText, _GUIToolTip_UpdateTipText

Exemple

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

Example()

Func Example()
    Local $hGUI = GUICreate(StringTrimRight(@ScriptName, StringLen(".exe")), 350, 200)

    Local $idAdd = GUICtrlCreateButton("Button", 30, 32, 130, 28)
    Local $hAdd = GUICtrlGetHandle($idAdd)

    ; Cr�e un contr�le info-bulle
    Local $hToolTip = _GUIToolTip_Create($hGUI)

    ; Ajoute un �l�ment au contr�le info-bulle
    _GUIToolTip_AddTool($hToolTip, 0, "Ceci est le texte du ToolTip", $hAdd)

    ; D�finit le titre de l'info-bulle
    _GUIToolTip_SetTitle($hToolTip, 'Ceci est le titre du ToolTip', $TTI_INFO)

    GUISetState(@SW_SHOW)

    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
   
    ; D�truit le contr�le info-bulle
    _GUIToolTip_Destroy($hToolTip)
    GUIDelete($hGUI)
EndFunc   ;==>Example