FMX.Graphics.TCanvas.BeginScene

• Aller au parent : TCanvas

Delphi

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

C++

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

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	FMX.Graphics.pas FMX.Graphics.hpp	FMX.Graphics	TCanvas

Description

Notifie à l'objet TCanvas que le dessin peut commencer.

Appelez BeginScene avant de dessiner sur le TCanvas.

Pour terminer la session de dessin, appelez EndScene.

Si une application a appelé BeginScene et que BeginScene renvoie True, l'application doit appeler EndScene. C'est-à-dire, le modèle d'appel recommandé doit ressembler à ceci :

if Canvas.BeginScene then
  try
    Canvas.xxx   //drawing image operations
    ...
  finally
    Canvas.EndScene;
  end;

A chaque fois que l'objet TCanvas appelle BeginScene et que BeginScene renvoie True, la valeur de la propriété BeginSceneCount est augmentée d'une unité. A chaque fois que l'objet TCanvas appelle EndScene, la valeur de la propriété BeginSceneCount est diminuée d'une unité. BeginScene utilise BeginSceneCount pour garantir que l'objet TCanvas n'a pas plus d'un dessin initialisé à tout moment.

Conseil : Le gestionnaire d'événements TForm.OnPaint d'une fiche n'a pas besoin d'appeler BeginScene explicitement.

Voir aussi

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