DateTime_SetFormat Makro (commctrl.h)

Artikel
08/22/2023

Legt die Anzeige eines DTP-Steuerelements (Datums- und Uhrzeitauswahl) basierend auf einer angegebenen Formatzeichenfolge fest. Sie können dieses Makro verwenden oder die DTM_SETFORMAT Nachricht explizit senden.

Syntax

void DateTime_SetFormat(
   hdp,
   sz
);

Parameter

hdp

Typ: HWND

Ein Handle für ein DTP-Steuerelement.

sz

Typ: LPCTSTR

Ein Zeiger auf eine Zeichenfolge mit null beendetem Format , die die gewünschte Anzeige definiert. Wenn Sie diesen Parameter auf NULL festlegen, wird das Steuerelement auf die Standardformatzeichenfolge für die aktuelle Formatvorlage zurückgesetzt.

Rückgabewert

Keine

Bemerkungen

Es ist akzeptabel, zusätzliche Zeichen in die Formatzeichenfolge einzuschließen, um eine umfangreichere Anzeige zu erzeugen. Alle nichtformatigen Zeichen müssen jedoch in einzelne Anführungszeichen eingeschlossen werden. Die Formatzeichenfolge "'Today is: 'hh':'m':'s dddMMMdd', 'yyy" würde beispielsweise eine Ausgabe wie "Today is: 04:22:31 Tuesday 23. März 1996" erzeugen.

Hinweis Ein DTP-Steuerelement verfolgt Gebietsschemaänderungen nach, wenn es die Standardformatzeichenfolge verwendet. Wenn Sie eine benutzerdefinierte Formatzeichenfolge festlegen, wird sie als Reaktion auf Gebietsschemaänderungen nicht aktualisiert.

Anforderungen


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

Share via