Struttura TTTOOLINFOA (commctrl.h)
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 |
---|---|
|
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. |
|
Centra la finestra della descrizione comando sotto lo strumento specificato dal membro uId . |
|
Indica che il membro uId è l'handle della finestra dello strumento. Se questo flag non è impostato, uId è l'identificatore dello strumento. |
|
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. |
|
Indica che il testo della descrizione comando verrà visualizzato nella direzione opposta al testo nella finestra padre. |
|
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. |
|
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 . |
|
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 |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per