Condividi tramite

Struttura NMTTDISPINFOA (commctrl.h)

  • Articolo

Contiene informazioni utilizzate per la gestione del 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;

Membri

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 superiore a 80 TCHAR, vedere i commenti nella sezione osservazioni di questo documento.

hinst

Tipo: HINSTANCE

Handle per 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 indica come interpretare il idFrom membro 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 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 letto nella stessa direzione del testo nella finestra padre. Per fare in modo che una descrizione comando venga letta nella direzione opposta dalla finestra padre, aggiungere il flag TTF_RTLREADING al uFlags membro 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 lo richiederà di nuovo.

lParam

Tipo: LPARAM

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

Osservazioni

È necessario puntare la matrice lpszText al proprio buffer privato quando il testo usato nella descrizione comando supera 80 TCHARlunghezza. Il sistema rimuove automaticamente l'acceleratore (&) TCHARs da tutte le stringhe passate a un controllo 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 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