_GUICtrlDTP_SetFormat
Setzt die Anzeige basierend auf einem gegebenen Formatstrings
#include <GuiDateTimePicker.au3>
_GUICtrlDTP_SetFormat ( $hWnd, $sFormat )
Parameter
| $hWnd | Handle des Controls |
| $sFormat | String welcher das gewünschte Format definiert. Falls dies auf leer gesetzt wird, so wird der Standard Formatstring für den aktuellen Stil zurückgesetzt. Man kann folgende Formatstrings verwenden: "d" - Tag mit einer oder zwei Ziffern "dd" - Tag mit zwei Ziffern. Tage mit einer Ziffer werden mit einer 0 aufgefüllt "ddd" - Die dreistellige Abkürzung für den Wochentag "dddd" - Der komplette Name des Wochentages "h" - Die Stunde mit einer oder zwei Ziffern im 12-Stunden Format "hh" - Die Stunde mit zwei Ziffern im 12-Stunden Format "H" - Die Stunde mit einer oder zwei Ziffern im 24-Stunden Format "HH" - Die Stunde mit zwei Ziffern im 24-Stunden Format "m" - Minute mit einer oder zwei Ziffern "mm" - Minute mit zwei Ziffern "M" - Monatsnummer mit einer oder zwei Ziffern "MM" - Monatsnummer mit zwei Ziffern "MMM" - Die dreistellige Abkürzung für den Monat "MMMM" - Der komplette Name des Monats "t" - Die einstellige Abkürzung für AM/PM "tt" - Die zweistellige Abkürzung für AM/PM "yy" - Die letzten zwei Ziffern des Jahres "yyyy" - Das komplette Jahr |
Rückgabewert
| Erfolg: | True |
| Fehler: | False |
Bemerkungen
Es ist akzeptabel zusätzliche Zeichen innerhalb des Formatstrings einzubeziehen um eine bessere Anzeige zu erhalten.
Allerdings muss jedes nicht dem Format entsprechendes Zeichen mit ' eingeschlossen werden.
Zum Beispiel: der Formatstring: "'Heute ist:
'hh':'m':'s ddddMMMdd', 'yyy" würde "Heute ist: 04:22:31 Tuesday Mar 23, 1996" ausgeben.
Es ist folgendes zu beachten: Ein DTP Control verfolgt lokale Änderungen, wenn der Standard Formatstring verwendet wird. Falls ein benutzerdefinierter Formatstring verwendet wird, wird es bei lokalen Änderungen nicht angepasst.
- - - - - - - - Erklärung der Controls - - - - - - - -
Beispiel
#include <GuiConstantsEx.au3>
#include <GuiDateTimePicker.au3>
Example()
Func Example()
Local $hDTP
; Erstellt eine GUI
GUICreate("DateTimePick: Setzt das Format (v" & @AutoItVersion & ")", 400, 300)
$hDTP = GUICtrlGetHandle(GUICtrlCreateDate("", 2, 6, 190))
GUISetState(@SW_SHOW)
; Setzt das Anzeigeformat
Local $iRet = _GUICtrlDTP_SetFormat($hDTP, "ddd MMM dd, yyyy hh:mm ttt")
ConsoleWrite('@@ Debug(' & @ScriptLineNumber & ') : $iRet = ' & $iRet & @CRLF & '>Error code: ' & @error & ' Extended code: ' & @extended & ' (0x' & Hex(@extended) & ')' & @CRLF) ;### Debug Console
; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
Do
Until GUIGetMsg() = $GUI_EVENT_CLOSE
GUIDelete()
EndFunc ;==>Example