PanelScreenGadget()

Syntax

Ergebnis = PanelScreenGadget(#ScreenGadget, x, y, Breite, Hoehe)

Erstellt ein Panel-Gadget innerhalb der aktuellen Gadgetliste.

Sobald ein Panel (Schalttafel, Register...) erstellt wurde, ist seine Liste mit Schaltflächen leer.

Parameter

#ScreenGadget	Eine Nummer zum Identifizieren des neuen Gadgets. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
x, y, Breite, Höhe	Die Position und Abmessungen des neuen Gadgets.

Rückgabewert

Gibt im Erfolgsfall einen Wert ungleich Null zurück, andernfalls Null. Wenn #PB_Any als #ScreenGadget Parameter verwendet wurde, dann enthält bei Erfolg der Rückgabewert die automatisch generierte Nummer.

Anmerkungen

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

Die folgenden Funktionen können verwendet werden, um auf das Gadget zuzugreifen:

- AddScreenGadgetItem(): fügt eine Schaltfläche hinzu.
- RemoveScreenGadgetItem(): entfernt eine Schaltfläche.
- CountScreenGadgetItems(): ermittelt die Anzahl der Schaltflächen.
- ClearScreenGadgetItems(): entfernt alle Schaltflächen.

- SetScreenGadgetState(): ändert den aktiven Panel (Schalttafel).
- GetScreenGadgetState(): ermittelt den Index des aktuellen Panels.

  #PB_Panel_ItemWidth : Gibt die Breite des inneren Bereichs zurück, worin die Gadgets angezeigt werden.
  #PB_Panel_ItemHeight: Gibt die Höhe des inneren Bereichs zurück, worin die Gadgets angezeigt werden.
  #PB_Panel_TabHeight : Gibt die Höhe der "Reiter" ("Panel-Tabs") am oberen Rand des Gadgets zurück.

Sie müssen erst AddScreenGadgetItem() aufrufen, um eine Schalttafel hinzufügen, bevor Sie andere Gadgets innerhalb des PanelGadget erstellen können. Die nächsten Gadgets werden dann automatisch auf dem neuen Panel-Gadget Eintrag erstellt. Dies ist sehr bequem. Wenn das Panel-Gadget mit allen benötigten Gadgets gefüllt wurde, muss CloseScreenGadgetList() aufgerufen werden, um zur vorhergehenden Gadgetliste zurückzukehren. Dies bedeutet, dass ein Panel-Gadget auch auf einem anderen Panel-Gadget erstellt werden kann.

Unterstützte OS

Alle