FMX.Graphics.TCanvas.BeginScene
Delphi
function BeginScene(AClipRects: PClipRects = nil; AContextHandle: THandle = 0): Boolean;
C++
bool __fastcall BeginScene(PClipRects AClipRects = (PClipRects)(0x0), NativeUInt AContextHandle = (NativeUInt)(0x0));
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | FMX.Graphics.pas FMX.Graphics.hpp |
FMX.Graphics | TCanvas |
説明
描画が開始されたことを、TCanvas オブジェクトに通知します。
BeginScene は、TCanvas 上に描画される前に呼び出されます。
描画セッションを終了するには、EndScene を呼び出します。
アプリケーションが BeginScene を呼び出し、BeginScene が True を返した場合、アプリケーションは EndScene を呼び出さなければなりません。 つまり、推奨される呼び出しパターンは次のようになります：
TCanvas オブジェクトが BeginScene を呼び出し、BeginScene が True を返すたびに、BeginSceneCount プロパティの値が 1 つ増加します。 TCanvas オブジェクトが EndScene を呼び出すたびに、BeginSceneCount プロパティの値は 1 つ減少します。 BeginScene は、BeginSceneCount を使用して、TCanvas オブジェクトがどの時点でも初期化された描画を 1 つしか持っていないことを保証します。
ヒント： フォームの TForm.OnPaint イベント ハンドラは、BeginScene を明示的に呼び出す必要はありません。