Condividi tramite


Struttura NMDATETIMEFORMATA (commctrl.h)

Contiene informazioni su una parte della stringa di formato che definisce un campo di callback all'interno di un controllo DTP (Date and Time Picker). Contiene la sottostringa che definisce il campo di callback e contiene un buffer per ricevere la stringa che verrà visualizzata nel campo di callback. Questa struttura viene usata con il codice di notifica DTN_FORMAT.

Sintassi

typedef struct tagNMDATETIMEFORMATA {
  NMHDR      nmhdr;
  LPCSTR     pszFormat;
  SYSTEMTIME st;
  LPCSTR     pszDisplay;
  CHAR       szDisplay[64];
} NMDATETIMEFORMATA, *LPNMDATETIMEFORMATA;

Membri

nmhdr

Tipo: NMHDR

Struttura NMHDR che contiene informazioni sul codice di notifica.

pszFormat

Tipo: LPCTSTR

Puntatore alla sottostringa che definisce un campo di callback del controllo DTP. La sottostringa è costituita da uno o più caratteri "X" seguiti da un carattere NULL. Per altre informazioni sui campi di callback, vedere campi di callback.)

st

Tipo: SYSTEMTIME

Struttura SYSTEMTIME che contiene la data e l'ora da formattare.

pszDisplay

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null contenente il testo visualizzato del controllo. Per impostazione predefinita, questo è l'indirizzo del membro szDisplay di questa struttura. È accettabile avere pszDisplay puntare a una stringa esistente. In questo caso, non è necessario assegnare un valore a szDisplay. Tuttavia, la stringa che pszDisplay punti a deve rimanere valida fino a quando non viene inviata un'altra notifica DTN_FORMAT o finché il controllo non viene eliminato definitivamente.

szDisplay[64]

Tipo: TCHAR

Buffer di 64 caratteri che deve ricevere la stringa con terminazione zero che verrà visualizzata dal controllo DTP. Non è necessario riempire l'intero buffer.

Osservazioni

Nota

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