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 que celles 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érieures. 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’elle est incluse dans Windows ou une version ultérieure. Pour utiliser Comctl32.dll version 6, spécifiez-la 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 des messages, tels que WM_MOUSEMOVE. Si cet indicateur n’est pas défini, vous devez utiliser le message TTM_RELAYEVENT pour transférer les messages vers le 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 contrôle d’info-bulle à transférer les messages d’événement de souris vers la fenêtre parente. 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 TTF_IDISHWND, uId doit 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 hwnd. Si uFlags inclut l’indicateur TTF_IDISHWND, ce membre est ignoré.

hinst

Type : HINSTANCE

Gérez vers le instance qui contient la ressource de chaîne pour 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 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, elle peut être définie sur NULL. Si lpszText a la valeur 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érieures. Valeur 32 bits définie par l’application qui est 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 mis 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 de l’info-bulle est lu dans le sens inverse du texte de la fenêtre parente.

Notes

L’en-tête commctrl.h définit TTTOOLINFO comme un 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête commctrl.h