Estrutura NMDATETIMEFORMATW (commctrl.h)

Contém informações sobre uma parte da cadeia de caracteres de formato que define um campo de retorno de chamada dentro de um controle DTP (seletor de data e hora). Ele carrega a subcadeia de caracteres que define o campo de retorno de chamada e contém um buffer para receber a cadeia de caracteres que será exibida no campo de retorno de chamada. Essa estrutura é usada com o código de notificação DTN_FORMAT.

Sintaxe

typedef struct tagNMDATETIMEFORMATW {
  NMHDR      nmhdr;
  LPCWSTR    pszFormat;
  SYSTEMTIME st;
  LPCWSTR    pszDisplay;
  WCHAR      szDisplay[64];
} NMDATETIMEFORMATW, *LPNMDATETIMEFORMATW;

Membros

nmhdr

Tipo: NMHDR

Uma estrutura de NMHDR que contém informações sobre o código de notificação.

pszFormat

Tipo: LPCTSTR

Um ponteiro para a subcadeia de caracteres que define um campo de retorno de chamada de controle DTP. A subcadeia de caracteres consiste em um ou mais caracteres "X" seguidos por um caractere NULL. (Para obter mais informações sobre campos de retorno de chamada, consulte campos de retorno de chamada.)

st

Tipo: SYSTEMTIME

Uma estrutura SYSTEMTIME que contém a data e a hora a serem formatadas.

pszDisplay

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto de exibição do controle. Por padrão, esse é o endereço do szDisplay membro dessa estrutura. É aceitável ter pszDisplay apontar para uma cadeia de caracteres existente. Nesse caso, você não precisa atribuir um valor a szDisplay. No entanto, a cadeia de caracteres que pszDisplay pontos deve permanecer válida até que outra notificação de DTN_FORMAT seja enviada ou até que o controle seja destruído.

szDisplay[64]

Tipo: TCHAR

Buffer de 64 caracteres que deve receber a cadeia de caracteres com término zero que o controle DTP exibirá. Não é necessário preencher todo o buffer.

Observações

Nota

O cabeçalho commctrl.h define NMDATETIMEFORMAT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	commctrl.h