ProgressBarGadget()

Syntax

Ergebnis = ProgressBarGadget(#Gadget, x, y, Breite, Höhe, Minimum, Maximum [, Flags])
Beschreibung
Erstellt ein ProgressBar-Gadget (auch: "Fortschrittsanzeige") innerhalb der aktuellen Gadgetliste.

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.
Minimum, Maximum Die Minimum- und Maximum-Werte, welche die Fortschrittsanzeige annehmen kann. Die Werte müssen zwischen 0 und 65536 liegen, damit sie auf allen OS funktionieren.
Flags (optional) Flags zum Verändern des Gadget-Verhaltens. Dies kann eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein:
  #PB_ProgressBar_Smooth   : Die Fortschrittsanzeige erfolgt stufenlos anstelle der Benutzung von Blöcken.
                             (Hinweis: Auf Windows XP mit eingeschalteten Skins und auf OS X hat dieses Flag keinen Effekt.)
  #PB_ProgressBar_Vertical : Die Fortschrittsanzeige erfolgt im vertikalen Modus.

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

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

Die folgenden Befehle können zum Zugriff auf das Gadget verwendet werden:

- SetGadgetState(): ändert den Wert der Fortschrittsanzeige. Ein Wert von #PB_ProgressBar_Unknown kann verwendet werden, um anzuzeigen, dass der Fortschritt nicht bekannt ist.
- GetGadgetState(): ermittelt den aktuellen Wert der Fortschrittsanzeige.
- SetGadgetAttribute(): mit den folgenden Attributen:
  #PB_ProgressBar_Minimum   : ändert den Minimum-Wert.
  #PB_ProgressBar_Maximum   : ändert den Maximum-Wert.
- GetGadgetAttribute(): mit den folgenden Attributen:
  #PB_ProgressBar_Minimum   : gibt den Minimum-Wert zurück.
  #PB_ProgressBar_Maximum   : gibt den Maximum-Wert zurück.
Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':
(Hinweis: Nur auf Windows unterstützt. Auf Windows XP mit eingeschalteten Skins hat diese Färbung keinen Effekt.)
  #PB_Gadget_FrontColor: Farbe des Fortschrittsbalkens
  #PB_Gadget_BackColor : Hintergrundfarbe

Beispiel

  If OpenWindow(0, 0, 0, 320, 160, "ProgressBarGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    TextGadget       (3,  10, 10, 250,  20, "ProgressBar Standard  (50/100)", #PB_Text_Center)
    ProgressBarGadget(0,  10, 30, 250,  30, 0, 100)
    SetGadgetState   (0, 50)   ;  wir setzen die erste ProgressBar (ID = 0) auf 50 von 100
    TextGadget       (4,  10, 70, 250,  20, "ProgressBar Smooth  (50/200)", #PB_Text_Center)
    ProgressBarGadget(1,  10, 90, 250,  30, 0, 200, #PB_ProgressBar_Smooth)
    SetGadgetState   (1, 50)   ;  wir setzen die zweite ProgressBar (ID = 1) auf 50 von 200
    TextGadget       (5, 100,135, 200,  20, "ProgressBar Vertical  (100/300)", #PB_Text_Right)
    ProgressBarGadget(2, 270, 10,  30, 120, 0, 300, #PB_ProgressBar_Vertical)
    SetGadgetState   (2, 100)   ; wir setzen die dritte ProgressBar (ID = 2) auf 100 von 300
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf

Siehe auch

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor()

Unterstützte OS

Alle

<- PanelGadget() - Gadget Inhaltsverzeichnis - RemoveGadgetColumn() ->