Vcl.Graphics.TCustomCanvas.OnChange

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnChange: TNotifyEvent read FOnChange write FOnChange;

C++

__property System::Classes::TNotifyEvent OnChange = {read=FOnChange, write=FOnChange};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event public
Vcl.Graphics.pas
Vcl.Graphics.hpp
Vcl.Graphics TCustomCanvas

Beschreibung

Wird unmittelbar nach jeder Änderung am Bild ausgelöst.

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Aktionen durchführen, wenn sich das Bild auf der Zeichenfläche geändert hat. Wenn eine Anwendung eine Zeichenmethode von TCustomCanvas aufruft, geschieht Folgendes:

  1. Das Ereignis OnChanging tritt ein.
  2. Die Methode TCustomCanvas nimmt die Änderung an der Zeichenfläche vor.
  3. Das Ereignis OnChange tritt ein.

OnChange-Ereignisse werden durch Änderungen am Bild ausgelöst, nicht durch Änderungen an den Eigenschaften der Zeichenfläche. Änderungen in abgeleiteten Zeichenflächenimplementierungen, die grafische Objekte wie Pinsel, Stift und Schriftart unterstützen, können durch die Zuweisung von OnChange-Ereignisbehandlungsroutinen an die entsprechenden Objekte verarbeitet werden. Die meisten von TCustomCanvas abgeleiteten Zeichenflächenimplementierungen verfügen aber über eigene OnChange-Ereignisbehandlungsroutinen für die zugehörigen Objekte. Bevor Sie also einem dieser Objekte (Stift, Pinsel usw.) eine OnChange-Ereignisbehandlungsroutine zuweisen, sollten Sie die bestehende Ereignisbehandlungsroutine ermitteln. Mit diesem Wert können Sie dann aus der neuen Ereignisbehandlungsroutine heraus die Ereignisbehandlungsroutine der von TCustomCanvas abgeleiteten Implementierung aufrufen.

Siehe auch