Struttura TTTOOLINFOA (commctrl.h)

Articolo
08/22/2023

La struttura TOOLINFO contiene informazioni su uno strumento in un controllo descrizione comando.

Sintassi

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;

Members

cbSize

Tipo: UINT

Dimensioni di questa struttura, in byte. Questo membro deve essere specificato.

uFlags

Tipo: UINT

Contrassegni che controllano la visualizzazione della descrizione comando. Questo membro può essere una combinazione dei valori seguenti:

Valore	Significato
TTF_ABSOLUTE	Posiziona la finestra della descrizione comando con le stesse coordinate fornite da TTM_TRACKPOSITION. Questo flag deve essere usato con il flag di TTF_TRACK.
TTF_CENTERTIP	Centra la finestra della descrizione comando sotto lo strumento specificato dal membro uId .
TTF_IDISHWND	Indica che il membro uId è l'handle della finestra dello strumento. Se questo flag non è impostato, uId è l'identificatore dello strumento.
TTF_PARSELINKS	Versione 6.0 e successiva. Indica che i collegamenti nel testo della descrizione comando devono essere analizzati. Si noti che Comctl32.dll versione 6 non è ridistribuibile, ma è incluso in Windows o versioni successive. Per usare Comctl32.dll versione 6, specificarlo in un manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.
TTF_RTLREADING	Indica che il testo della descrizione comando verrà visualizzato nella direzione opposta al testo nella finestra padre.
TTF_SUBCLASS	Indica che il controllo della descrizione comando deve sottoclasse la finestra dello strumento per intercettare i messaggi, ad esempio WM_MOUSEMOVE. Se questo flag non è impostato, è necessario usare il messaggio di TTM_RELAYEVENT per inoltrare messaggi al controllo descrizione comando. Per un elenco di messaggi che un controllo descrizione comando elabora, vedere TTM_RELAYEVENT.
TTF_TRACK	Posiziona la finestra della descrizione comando accanto allo strumento a cui corrisponde e sposta la finestra in base alle coordinate fornite dai messaggi di TTM_TRACKPOSITION . È necessario attivare questo tipo di strumento usando il messaggio di TTM_TRACKACTIVATE .
TTF_TRANSPARENT	Causa l'inoltro dei messaggi degli eventi del mouse alla finestra padre del controllo della descrizione comando. Ciò è limitato agli eventi del mouse che si verificano all'interno dei limiti della finestra della descrizione comando.

hwnd

Tipo: HWND

Handle nella finestra contenente lo strumento. Se lpszText include il valore LPSTR_TEXTCALLBACK, questo membro identifica la finestra che riceve i codici di notifica TTN_GETDISPINFO.

uId

Tipo: UINT_PTR

Identificatore definito dall'applicazione dello strumento. Se uFlags include il flag TTF_IDISHWND, uId deve specificare l'handle della finestra allo strumento.

rect

Tipo: RECT

Coordinate del rettangolo di selezione dello strumento. Le coordinate sono relative all'angolo superiore sinistro dell'area client della finestra identificata da hwnd. Se uFlags include il flag di TTF_IDISHWND, questo membro viene ignorato.

hinst

Tipo: HINSTANCE

Gestire l'istanza che contiene la risorsa stringa per lo strumento. Se lpszText specifica l'identificatore di una risorsa stringa, viene usato questo membro.

lpszText

Tipo: LPTSTR

Puntatore al buffer contenente il testo per lo strumento o l'identificatore della risorsa stringa contenente il testo. Questo membro viene talvolta usato per restituire i valori. Se è necessario esaminare il valore restituito, deve puntare a un buffer valido di dimensioni sufficienti. In caso contrario, può essere impostato su NULL. Se lpszText è impostato su LPSTR_TEXTCALLBACK, il controllo invia il codice di notifica TTN_GETDISPINFO alla finestra del proprietario per recuperare il testo.

lParam

Tipo: LPARAM

Versione 4.70 e successiva. Valore definito dall'applicazione a 32 bit associato allo strumento.

lpReserved

Tipo: void*

Riservato. Deve essere impostato su NULL.

Commenti

Le finestre normali visualizzano testo da sinistra a destra (LTR). Windows può essere mirrorato per visualizzare lingue come ebraico o arabo che leggevano RTL (destra a sinistra). In genere, il testo della descrizione comando viene visualizzato nella stessa direzione del testo nella finestra padre. Se TTF_RTLREADING è impostato, il testo della descrizione comando verrà letto nella direzione opposta dal testo nella finestra padre.

Nota

L'intestazione commctrl.h definisce TTTOOLINFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	commctrl.h

Share via