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	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.
Date (optional)	Das anfänglich zu verwendende Datum. 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 (nicht unterstützt auf Linux).

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.
                        (Hinweis: Begrenzung des auswählbaren Datums wird auf Linux nicht unterstützt.)

- 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.
                        (Hinweis: Begrenzung des auswählbaren Datums wird auf Linux nicht unterstützt.)

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 (nicht unterstützt auf Windows Vista+)
  #PB_Gadget_TitleBackColor : Hintergrundfarbe für den Monatstitel (nicht unterstützt auf Windows Vista+)
  #PB_Gadget_TitleFrontColor: Textfarbe für den Monatstitel (nicht unterstützt auf Windows Vista+)
  #PB_Gadget_GrayTextColor  : Textfarbe für Tage, welche nicht im aktuellen Monat liegen (nicht unterstützt auf Windows Vista+)

Beispiel

  If OpenWindow(0, 0, 0, 250, 200, "CalendarGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CalendarGadget(0, 10, 10, 230, 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