Structure TTTOOLINFOA (commctrl.h)
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 |
---|---|
|
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. |
|
Centre la fenêtre d’info-bulle sous l’outil spécifié par le membre uId . |
|
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. |
|
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. |
|
Indique que le texte de l’info-bulle s’affiche dans la direction opposée au texte de la fenêtre parente. |
|
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. |
|
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 . |
|
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 |