Struttura NMTTDISPINFOA (commctrl.h)

Articolo
08/22/2023

Contiene informazioni usate per gestire il codice di notifica TTN_GETDISPINFO . Questa struttura sostituisce la struttura TOOLTIPTEXT .

Sintassi

typedef struct tagNMTTDISPINFOA {
  NMHDR     hdr;
  LPSTR     lpszText;
  char      szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOA, *LPNMTTDISPINFOA;

Members

hdr

Tipo: NMHDR

Struttura NMHDR che contiene informazioni aggiuntive sulla notifica.

lpszText

Tipo: LPTSTR

Puntatore a una stringa con terminazione null che verrà visualizzata come testo della descrizione comando. Se hinst specifica un handle di istanza, questo membro deve essere l'identificatore di una risorsa stringa.

szText[80]

Tipo: TCHAR

Buffer che riceve il testo della descrizione comando. Un'applicazione può copiare il testo in questo buffer anziché specificare un indirizzo stringa o una risorsa stringa. Per il testo della descrizione comando che supera 80 TCHARs, vedere commenti nella sezione osservazioni di questo documento.

hinst

Tipo: HINSTANCE

Gestire l'istanza che contiene una risorsa stringa da usare come testo della descrizione comando. Se lpszText è l'indirizzo della stringa di testo della descrizione comando, questo membro deve essere NULL.

uFlags

Tipo: UINT

Flag che indicano come interpretare il membro idFrom della struttura NMHDR inclusa.

Valore	Significato
TTF_IDISHWND	Se questo flag è impostato, idFrom è l'handle dello strumento. In caso contrario, è l'identificatore dello strumento.
TTF_RTLREADING	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 letto nella stessa direzione del testo nella finestra padre. Per avere una descrizione comando in lettura nella direzione opposta dalla finestra padre, aggiungere il flag TTF_RTLREADING al membro uFlags durante l'elaborazione della notifica.
TTF_DI_SETITEM	Versione 4.70. Se si aggiunge questo flag a uFlags durante l'elaborazione della notifica, il controllo descrizione comando manterrà le informazioni fornite e non la richiederà di nuovo.

lParam

Tipo: LPARAM

Versione 4.70. Dati definiti dall'applicazione associati allo strumento.

Commenti

È necessario puntare la matrice lpszText al proprio buffer privato quando il testo usato nella descrizione comando supera la lunghezza di 80 TCHAR. Il sistema rimuove automaticamente l'amperand (&) acceleratore TCHARs da tutte le stringhe passate a un controllo della descrizione comando, a meno che il controllo non abbia lo stile TTS_NOPREFIX .

Nota

L'intestazione commctrl.h definisce NMTTDISPINFO 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


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

Share via