DateGadget()

Syntax

Ergebnis = DateGadget(#Gadget, x, y, Breite, Höhe [, Maske$ [, Datum [, Flags]]])

Erstellt ein Stringgadget innerhalb der aktuellen Gadgetliste, in welchem ein Datum und/oder eine Zeit eingegeben werden kann.

Parameter

#Gadget	Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Die Position und die Abmessungen des neuen Gadgets.
Mask$ (optional)	Das Format, in welchem das Datum eingegeben werden kann. Siehe FormatDate() für das Format dieser Maske. Wichtiger Hinweis: Das Gadget unterstützt nicht die Anzeige von Sekunden, wenn Sie also "%ss" im 'Maske$' Parameter angeben, wird dies einfach ignoriert! Wenn Sie keine Maske oder einen leeren String angeben, wird eine Standardmaske verwendet. Die Maske kann mittels dem Befehl SetGadgetText() verändert werden.
Date (optional)	Das anfänglich anzuzeigende Datum für das Gadget. Ohne diesen Parameter oder die Angabe einer 0 wird das aktuelle Datum verwendet.
Flags (optional)	Flags zum Verändern des Gadget-Verhaltens: Standardmäßig hat das Gadget einen Schalter zum Aufrufen eines Kalenders, in welchem der Anwender ein Datum auswählen kann (siehe Bild weiter unten). Sie können dies ändern, wenn Sie #PB_Date_UpDown als 'Flags' Parameter angeben. Dies versieht das Gadget mit einem Hoch/Runter-Schalter, mit welchem der Anwender den aktuell ausgewählten Teil des Gadgets verändern kann. Diese Option ist nur auf Windows verfügbar. Wenn Sie #PB_Date_CheckBox als 'Flags' Parameter angeben, dann bekommt das Gadget eine Häkchen-Box, mit der der Anwender das Gadget auf "kein Datum" setzen kann (sofern kein Häkchen gesetzt). In der Zeit, in der kein Häkchen gesetzt ist, gibt GetGadgetState() den Wert 0 zurück. Um den Status der Häkchen-Box zu ändern, benutzen Sie SetGadgetState() entweder mit 0 (= kein Häkchen gesetzt) oder jedem gültigen Datum (= Häkchen gesetzt).

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

Dieses Gadget verwendet das gleiche Datumsformat für seine Funktionen wie die Date Bibliothek. Damit können Sie z.B. FormatDate() verwenden, um die mittels GetGadgetState() erhaltenen Ergebnisse in einem ordentlichen Datumsformat anzuzeigen.

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Die folgenden Befehle können bei diesem Gadget verwendet werden:

- SetGadgetState(): Setzt das aktuell angezeigte Datum.
- SetGadgetText(): Ändert die Eingabemaske des Gadgets.
- GetGadgetState(): Ermittelt das aktuell angezeigte Datum.
- GetGadgetText(): Ermittelt das aktuell angezeigte Datum als ein String, wie dieser im Gadget angezeigt wird.
- GetGadgetAttribute(): Mit den folgenden Attributen:

  #PB_Date_Minimum: ermittelt das kleinste Datum, welches eingegeben werden kann
  #PB_Date_Maximum: ermittelt das größte Datum, welches eingegeben werden kann

- SetGadgetAttribute(): Mit den folgenden Attributen:

  #PB_Date_Minimum: legt das kleinste Datum fest, welches eingegeben werden kann
  #PB_Date_Maximum: legt das größte Datum fest, welches eingegeben werden kann

Die folgenden Ereignisse werden mittels EventType() unterstützt:

  #PB_EventType_Change: Das Datum wurde durch den Anwender geändert.

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp', um den Aufklapp-Kalender einzufärben (der Eingabebereich kann nicht eingefärbt werden):

  #PB_Gadget_BackColor      : Hintergrundfarbe
  #PB_Gadget_FrontColor     : Textfarbe für angezeigte Tage
  #PB_Gadget_TitleBackColor : Hintergrundfarbe für den Monatstitel
  #PB_Gadget_TitleFrontColor: Textfarbe für den Monatstitel
  #PB_Gadget_GrayTextColor  : Textfarbe für Tage, welche nicht im aktuellen Monat liegen

Beispiel

  If OpenWindow(0, 0, 0, 200, 250, "DateGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    DateGadget(0, 10, 10, 180, 25, "Datum: %mm/%dd/%yyyy Time: %hh:%ii")
    Repeat
    Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

GetGadgetState(), SetGadgetState(), GetGadgetText(), SetGadgetText(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor(), CalendarGadget(), Date(), FormatDate()

Unterstützte OS

Alle