CalendarGadget()

Syntax

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

Erstellt ein Kalendergadget innerhalb der aktuellen Gadgetliste. Dieses Gadget stellt einen Monatskalender dar und lässt den Anwender ein Datum auswählen.

Parameter

#Gadget	Gibt eine Nummer an, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Geben die Position und die Abmessungen des neuen Gadgets an.
Date (optional)	Gibt das anfänglich zu verwendende Datum an. Der Standard ist das aktuelle Datum.
Flags (optional)	Dieser Parameter kann auf #PB_Calendar_Borderless gesetzt werden, um das Gadget ohne einen Rand zu erstellen.

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

Die von diesem Gadget und seinen relevanten Befehlen verwendeten Datumsangaben benutzen das gleiche Datumsformat wie die Date Bibliothek.

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

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

- SetGadgetState(): setzt das aktuell anzuzeigende Datum.
- GetGadgetState(): ermittelt das aktuell angezeigte Datum.
- SetGadgetItemState(): bewirkt die Ausgabe eines spezifischen Datums in Fettschrift (nur auf Windows).
- GetGadgetItemState(): ermittelt den Status (Fettschrift an/aus) eines spezifischen Datums (nur auf Windows).
- SetGadgetAttribute(): mit den folgenden Attributen:

  #PB_Calendar_Minimum: legt das kleinste auswählbare Datum fest
  #PB_Calendar_Maximum: legt das größte auswählbare Datum in diesem Gadget fest.

- GetGadgetAttribute(): mit den folgenden Attributen:

  #PB_Calendar_Minimum: ermittelt das kleinste Datum, was ausgewählt werden kann
  #PB_Calendar_Maximum: ermittelt das größte Datum, was in diesem Gadget ausgewählt werden kann.

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':

  #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, 220, 200, "CalendarGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CalendarGadget(0, 10, 10, 200, 180)
    Repeat
    Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

SetGadgetState(), GetGadgetState(), SetGadgetItemState(), GetGadgetItemState(), SetGadgetAttribute(), GetGadgetAttribute(), SetGadgetColor(), GetGadgetColor(), DateGadget(), Date(), FormatDate()

Unterstützte OS

Alle