Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird die Nummer des neuen Gadgets als 'Ergebnis' zurückgegeben.
Die möglichen Werte, die das ProgressBar-Gadget verarbeiten kann, sind begrenzt auf den mit 'Minimum' und 'Maximum' angegebenen Bereich.
'Flags' sind immer optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:
#PB_ProgressBar_Smooth : Die Fortschrittsanzeige erfolgt stufenlos anstelle der Benutzung von Blöcken.
(Hinweis: Auf Windows XP mit eingeschalteten Skins hat diese Färbung keinen Effekt.)
#PB_ProgressBar_Vertical : Die Fortschrittsanzeige erfolgt im vertikalen Modus.
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 aktuellen Wert der Fortschrittsanzeige.
- 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: 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
