FMX.Graphics.TCanvas.BeginScene

• Übergeordnet: TCanvas

Delphi

function BeginScene(AClipRects: PClipRects = nil; AContextHandle: THandle = 0): Boolean;

C++

bool __fastcall BeginScene(PClipRects AClipRects = (PClipRects)(0x0), NativeUInt AContextHandle = (NativeUInt)(0x0));

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	FMX.Graphics.pas FMX.Graphics.hpp	FMX.Graphics	TCanvas

Beschreibung

Benachrichtigt das TCanvas-Objekt darüber, dass das Zeichnen gestartet werden kann.

Rufen Sie BeginScene auf, bevor das Zeichnen auf das TCanvas-Objekt gestartet wird.

Um die Zeichensitzung zu beenden, rufen Sie EndScene auf.

Wenn die Funktion BeginScene von einer Anwendung aufgerufen wurde und True zurückgegeben wird, dann muss EndScene aufgerufen werden. Das heißt, dass das empfohlene Aufrufmuster folgendermaßen aussehen sollte:

if Canvas.BeginScene then
  try
    Canvas.xxx   //Operationen zum Zeichnen des Bildes
    ...
  finally
    Canvas.EndScene;
  end;

Wenn das TCanvas-Objekt die Funktion BeginScene aufruft und True zurückgegeben wird, wird der Wert der Eigenschaft BeginSceneCount um eins erhöht. Wenn das TCanvas-Objekt die Funktion EndScene aufruft, wird der Wert der Eigenschaft BeginSceneCount um eins verringert. BeginScene verwendet BeginSceneCount zum Sicherstellen, dass für das TCanvas-Objekt zu jedem Zeitpunkt nur eine Zeichenoperation initialisiert ist.

Tipp: Die Ereignisbehandlungsroutine TForm.OnPaint eines Formulars muss BeginScene nicht explizit aufrufen.

Siehe auch

• FMX.Graphics.TCanvas.EndScene
• FMX.Graphics.TCanvas.BeginSceneCount