Struttura NMDATETIMEFORMATA (commctrl.h)

Contiene informazioni su una parte della stringa di formato che definisce un campo di callback all'interno di un controllo selezione data e ora (DTP). 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;

Members

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, si tratta dell'indirizzo del membro szDisplay di questa struttura. È accettabile che pszDisplay punti a una stringa esistente. In questo caso, non è necessario assegnare un valore a szDisplay. Tuttavia, la stringa che pszDisplay punta 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.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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