ProgressOn
Beschreibung anzeigen in
Zeigt ein konfigurierbares Progressbarfenster an.
ProgressOn ( "title", "maintext" [, "subtext" [, x pos [, y pos [, opt]]]] )
Parameter
| title | Der Titel des Progressbarfensters. |
| maintext | Der Text für das obere, fettgedruckte Haupttextlabel. |
| subtext | [optional] Der Text für das untere, normal geschriebenes Textlabel (standardmäßig ist leer). |
| x pos | [optional] Die Position (in Pixeln) des Progressbarfensters von links (standardmäßig zentriert). |
| y pos | [optional] Die Position (in Pixeln) des Progressbarfensters von oben (standardmäßig zentriert). |
| opt | [optional] Standard ist "immer im Vordergrund, mit Titelleiste, nicht verschiebbar" Die folgenden Optionswerte können auch addiert werden. $DLG_NOTITLE (1) = ohne Rand, Fenster ohne Titelzeile $DLG_NOTONTOP (2) = ohne das "Immer im Vordergrund"-Attribut $DLG_MOVEABLE (16) = Fenster kann verschoben werden Die Konstanten sind in AutoItConstants.au3 definiert |
Rückgabewert
Keine.Bemerkungen
Um optionale Parameter anzugeben und dennoch den Standardwert zu erhalten, sind folgende Werte zu benutzen:
"" für String-Parameter
-1 für numerische Parameter
Wenn ProgressOn() aufgerufen wird, während bereits ein Progressbarfenster angezeigt wird, wird dieses angepasst. (Wenn mehrere Progressbarfenster gleichzeitig angezeigt werden sollen, sind mehrere Skripte zu verwenden.)
Wenn man einen Haupttext von 2 Zeilen verwenden will, der mit ProgressSet() gesetzt wird, muss man auch das Fortschrittsfenster mit 2 Zeilen definieren.
Mehr als 2 Zeilen führen zu einer unübersichtlichen Darstellung.
Verwandte Funktionen
Beispiel
#include <AutoItConstants.au3>
Example()
Func Example()
; Zeigt ein Fortschrittsfenster (Haupttext mit 2 Zeilen)
ProgressOn("Fortschritt", "Erhöhung in jeder Sekunde" & @CRLF & "..." , "0%", -1, -1, BitOR($DLG_NOTONTOP, $DLG_MOVEABLE))
; Veränderte den Fortschrittswert der Progressbar jede Sekunde.
For $i = 10 To 100 Step 10
Sleep(1000)
ProgressSet($i, $i & "%")
Next
; Setzt den "subtext" und "maintext" des Fortschrittsfenster..
ProgressSet(100, "Erledigt", "Komplett")
Sleep(5000)
; Schließt das Fortschrittsfenster.
ProgressOff()
EndFunc ;==>Example