Vcl.Graphics.TProgressEvent
Delphi
TProgressEvent = procedure (Sender: TObject; Stage: TProgressStage;
PercentDone: Byte; RedrawNow: Boolean; const R: TRect; const Msg: string) of object;
C++
typedef void __fastcall (__closure *TProgressEvent)(System::TObject* Sender, TProgressStage Stage, System::Byte PercentDone, bool RedrawNow, const Winapi::Windows::TRect &R, const System::UnicodeString Msg);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
type typedef |
public | Vcl.Graphics.pas Vcl.Graphics.hpp |
Vcl.Graphics | Vcl.Graphics |
Beschreibung
TProgressEvent ist der Typ für Ereignisbehandlungsroutinen, die den Fortgang längerer Operationen anzeigen.
Sender ist das Objekt, das die Ereignisbenachrichtigung empfängt. Dies ist normalerweise die Komponente, welche die Operation initiiert hat.
Stage gibt an, ob die Operation beginnt, fortgesetzt oder beendet wird. In der Ereignisbehandlungsroutine kann z.B. eine Fortschrittsanzeige erzeugt werden, wenn Stage den Wert psStarting hat. Danach wird sie so lange laufend aktualisiert, wie State den Wert psRunning hat, und entfernt, sobald StatepsEnding ist.
PercentDone gibt den Fortschritt der Operation in Prozent an. Bei dem Parameter PercentDone handelt es sich um einen Annäherungswert. Mit PercentDone können Sie eine Fortschrittsanzeige oder ein ähnliches Steuerelement aktualisieren.
RedrawNow gibt an, ob der Fortgang der Operation ohne Probleme als Grafik ausgegeben werden kann.
R gibt den Größe des Bereichs an, der sich geändert hat und neu gezeichnet werden muss.
Msg enthält ein oder zwei Wörter, mit denen die Operation beschrieben wird. Sie könnten Msg beispielsweise einen String wie "Laden", "Speichern" oder "Farben reduzieren" zuweisen. Der Msg-String kann aber auch leer bleiben.
TProgressEvent ist der Typ der Ereignisbahandlungsroutinen für Vcl.Graphics.TGraphic.OnProgress, Vcl.Graphics.TPicture.OnProgress und Vcl.ExtCtrls.TImage.OnProgress einer Listenansicht.