Freigeben über

NMDATETIMEFORMATA-Struktur (commctrl.h)

  • Artikel

Enthält Informationen zu einem Teil der Formatzeichenfolge, der ein Rückruffeld innerhalb eines DTP-Steuerelements (Datums- und Uhrzeitauswahl) definiert. Sie enthält die Teilzeichenfolge, die das Rückruffeld definiert, und enthält einen Puffer, um die Zeichenfolge zu empfangen, die im Rückruffeld angezeigt wird. Diese Struktur wird mit dem DTN_FORMAT Benachrichtigungscode verwendet.

Syntax

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

Member

nmhdr

Typ: NMHDR

Eine NMHDR-Struktur , die Informationen zum Benachrichtigungscode enthält.

pszFormat

Typ: LPCTSTR

Ein Zeiger auf die Teilzeichenfolge, die ein DTP-Steuerelementrückruffeld definiert. Die Teilzeichenfolge besteht aus einem oder mehreren "X"-Zeichen gefolgt von einem NULL-Zeichen. (Weitere Informationen zu Rückruffeldern finden Sie unter Rückruffelder.)

st

Typ: SYSTEMTIME

Eine SYSTEMTIME-Struktur , die das zu formatierende Datum und die Uhrzeit enthält.

pszDisplay

Typ: LPCTSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den Anzeigetext des Steuerelements enthält. Standardmäßig ist dies die Adresse des szDisplay-Members dieser Struktur. Es ist akzeptabel, dass pszDisplay auf eine vorhandene Zeichenfolge zeigt. In diesem Fall müssen Sie szDisplay keinen Wert zuweisen. Die Zeichenfolge, auf die pszDisplay verweist, muss jedoch gültig bleiben, bis eine andere DTN_FORMAT Benachrichtigung gesendet wird oder bis das Steuerelement zerstört wird.

szDisplay[64]

Typ: TCHAR

64-Zeichen-Puffer, der die Zeichenfolge ohne Ende empfangen soll, die vom DTP-Steuerelement angezeigt wird. Es ist nicht erforderlich, den gesamten Puffer zu füllen.

Hinweise

Hinweis

Der commctrl.h-Header definiert NMDATETIMEFORMAT als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile commctrl.h