NMDATETIMEFORMATA-Struktur (commctrl.h)

Enthält Informationen zu einem Teil der Formatzeichenfolge, der ein Rückruffeld innerhalb eines Datums- und Uhrzeitauswahl-Steuerelements (DTP) definiert. Sie enthält die Teilzeichenfolge, die das Rückruffeld definiert und einen Puffer enthält, 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;

Angehörige

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 mit Null beendete Zeichenfolge, die den Anzeigetext des Steuerelements enthält. Standardmäßig ist dies die Adresse des szDisplay Member dieser Struktur. Es ist akzeptabel, pszDisplay auf eine vorhandene Zeichenfolge verweisen zu lassen. In diesem Fall müssen Sie szDisplaykeinen Wert zuweisen. Die Zeichenfolge, 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-stellige Puffer, der die Zeichenfolge mit Nullen empfängt, die vom DTP-Steuerelement angezeigt wird. Es ist nicht erforderlich, den gesamten Puffer auszufüllen.

Bemerkungen

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	commctrl.h