Struttura TTTOOLINFOW (commctrl.h)

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

Sintassi

typedef struct tagTOOLINFOW {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPWSTR    lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOW, *PTOOLINFOW, *LPTTTOOLINFOW;

Membri

cbSize

Tipo: UINT

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

uFlags

Tipo: UINT

Flag 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 alle stesse coordinate fornite da TTM_TRACKPOSITION. Questo flag deve essere usato con il flag 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 per lo strumento. Se questo flag non è impostato, uId è l'identificatore dello strumento.
TTF_PARSELINKS	versione 6.0 e successive. 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 descrizione comando deve sottoclassare la finestra dello strumento per intercettare i messaggi, ad esempio WM_MOUSEMOVE. Se questo flag non è impostato, è necessario utilizzare il messaggio TTM_RELAYEVENT per inoltrare i messaggi al controllo descrizione comando. Per un elenco di messaggi elaborati da un controllo descrizione comando, 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 TTM_TRACKPOSITION. È necessario attivare questo tipo di strumento usando il messaggio di TTM_TRACKACTIVATE.
TTF_TRANSPARENT	Fa sì che il controllo descrizione comando inoltra i messaggi di evento del mouse alla finestra padre. Questo è limitato agli eventi del mouse che si verificano all'interno dei limiti della finestra della descrizione comando.

hwnd

Tipo: HWND

Handle per la finestra che contiene 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 di TTF_IDISHWND, uId deve specificare l'handle della finestra per lo strumento.

rect

Tipo: RECT

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

hinst

Tipo: HINSTANCE

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

lpszText

Tipo: LPTSTR

Puntatore al buffer che contiene il testo dello strumento o identificatore della risorsa stringa che contiene il testo. Questo membro viene talvolta utilizzato per restituire 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 successive. Valore definito dall'applicazione a 32 bit associato allo strumento.

lpReserved

Tipo: void*

Riservato. Deve essere impostato su NULL.

Osservazioni

Le finestre normali visualizzano testo da sinistra a destra (LTR). Windows può essere con mirroring per visualizzare lingue come l'ebraico o l'arabo che leggono da destra a sinistra (RTL). 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	commctrl.h