Estrutura NMDATETIMEFORMATA (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 tagNMDATETIMEFORMATA {
  NMHDR      nmhdr;
  LPCSTR     pszFormat;
  SYSTEMTIME st;
  LPCSTR     pszDisplay;
  CHAR       szDisplay[64];
} NMDATETIMEFORMATA, *LPNMDATETIMEFORMATA;

Membros

nmhdr

Tipo: NMHDR

Uma estrutura 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 membro szDisplay dessa estrutura. É aceitável que o pszDisplay aponte para uma cadeia de caracteres existente. Nesse caso, você não precisa atribuir um valor ao szDisplay. No entanto, a cadeia de caracteres para a qual pszDisplay aponta 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 terminada em zero que o controle DTP exibirá. Não é necessário preencher todo o buffer.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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