Structure TTTOOLINFOA (commctrl.h)

  • Article

La structure TOOLINFO contient des informations sur un outil dans un contrôle d’info-bulle.

Syntaxe

typedef struct tagTOOLINFOA {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPSTR     lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOA, *PTOOLINFOA, *LPTTTOOLINFOA;

Membres

cbSize

Type : UINT

Taille de cette structure, en octets. Ce membre doit être spécifié.

uFlags

Type : UINT

Indicateurs qui contrôlent l’affichage de l’info-bulle. Ce membre peut être une combinaison des valeurs suivantes :

Valeur Signification
TTF_ABSOLUTE
 Positionne la fenêtre d’info-bulle sur les mêmes coordonnées fournies par TTM_TRACKPOSITION. Cet indicateur doit être utilisé avec l’indicateur TTF_TRACK.
TTF_CENTERTIP
 Centre la fenêtre d’info-bulle sous l’outil spécifié par le membre uId.
TTF_IDISHWND
 Indique que le membre uId est le handle de fenêtre de l’outil. Si cet indicateur n’est pas défini, uId est l’identificateur de l’outil.
TTF_PARSELINKS

version 6.0 et ultérieure. Indique que les liens dans le texte de l’info-bulle doivent être analysés.

Notez que Comctl32.dll version 6 n’est pas redistribuable, mais qu’il est inclus dans Windows ou version ultérieure. Pour utiliser Comctl32.dll version 6, spécifiez-le dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.
TTF_RTLREADING
 Indique que le texte de l’info-bulle s’affiche dans la direction opposée au texte de la fenêtre parente.
TTF_SUBCLASS
 Indique que le contrôle d’info-bulle doit sous-classer la fenêtre de l’outil pour intercepter les messages, tels que WM_MOUSEMOVE. Si cet indicateur n’est pas défini, vous devez utiliser le message TTM_RELAYEVENT pour transférer des messages au contrôle d’info-bulle. Pour obtenir la liste des messages qu’un contrôle d’info-bulle traite, consultez TTM_RELAYEVENT.
TTF_TRACK
 Positionne la fenêtre d’info-bulle en regard de l’outil auquel elle correspond et déplace la fenêtre en fonction des coordonnées fournies par les messages TTM_TRACKPOSITION. Vous devez activer ce type d’outil à l’aide du message TTM_TRACKACTIVATE.
TTF_TRANSPARENT
 Provoque le transfert des messages d’événement de souris vers la fenêtre parente du contrôle d’info-bulle. Cela est limité aux événements de souris qui se produisent dans les limites de la fenêtre d’info-bulle.

hwnd

Type : HWND

Gérez la fenêtre qui contient l’outil. Si lpszText inclut la valeur LPSTR_TEXTCALLBACK, ce membre identifie la fenêtre qui reçoit les codes de notification TTN_GETDISPINFO.

uId

Type : UINT_PTR

Identificateur défini par l’application de l’outil. Si uFlags inclut l’indicateur de TTF_IDISHWND, uId devez spécifier le handle de fenêtre à l’outil.

rect

Type : RECT

Coordonnées du rectangle englobant de l’outil. Les coordonnées sont relatives au coin supérieur gauche de la zone cliente de la fenêtre identifiée par . Si uFlags inclut l’indicateur TTF_IDISHWND, ce membre est ignoré.

hinst

Type : HINSTANCE

Gérez l’instance qui contient la ressource de chaîne de l’outil. Si lpszText spécifie l’identificateur d’une ressource de chaîne, ce membre est utilisé.

lpszText

Type : LPTSTR

Pointeur vers la mémoire tampon qui contient le texte de l’outil ou l’identificateur de la ressource de chaîne qui contient le texte. Ce membre est parfois utilisé pour retourner des valeurs. Si vous devez examiner la valeur retournée, vous devez pointer vers une mémoire tampon valide de taille suffisante. Sinon, il peut être défini sur NULL . Si lpszText est défini sur LPSTR_TEXTCALLBACK, le contrôle envoie le code de notification TTN_GETDISPINFO à la fenêtre propriétaire pour récupérer le texte.

lParam

Type : LPARAM

version 4.70 et ultérieure. Valeur définie par l’application 32 bits associée à l’outil.

lpReserved

Type : void*

Réservé. Doit être défini sur NULL.

Remarques

Les fenêtres normales affichent le texte de gauche à droite (LTR). Windows peut être mise en miroir pour afficher des langues telles que l’hébreu ou l’arabe qui lisent de droite à gauche (RTL). Normalement, le texte d’info-bulle s’affiche dans la même direction que le texte dans sa fenêtre parente. Si TTF_RTLREADING est défini, le texte d’info-bulle lit dans la direction opposée du texte dans la fenêtre parente.

Note

L’en-tête commctrl.h définit TTTOOLINFO comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête commctrl.h