Vcl.ExtCtrls.TCustomCategoryPanel.DrawHeaderBackground
Delphi
procedure DrawHeaderBackground(ACanvas: TCanvas); virtual;
C++
virtual void __fastcall DrawHeaderBackground(Vcl::Graphics::TCanvas* ACanvas);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
protected | Vcl.ExtCtrls.pas Vcl.ExtCtrls.hpp |
Vcl.ExtCtrls | TCustomCategoryPanel |
説明
カテゴリ パネルのヘッダーの背景を描画します。
DrawHeaderBackground を使用して、親のカテゴリ パネルのプロパティに従って、カテゴリ パネルの背景を描画します。ACanvas パラメータは、キャンバスの Handle プロパティに割り当てられたウィンドウのデバイス コンテキストを使って作成した TCanvas インスタンスを要求します。DrawHeaderBackground が呼び出された後、このキャンバス インスタンスを解放する必要があります。
DrawHeaderBackground によって描画される四角形は、このコントロールの ClientRect に指定されており、四角形の一番下は HeaderHeight に設定されています。ヘッダーは、カテゴリ パネル グループの親のプロパティに従って描画されます。
カテゴリ パネル グループの HeaderStyle プロパティが hsGradient に設定されている場合、GraphUtil 関数の GradientFillCanvas がカテゴリ パネル グループの GradientBaseColor プロパティ、GradientColor プロパティ、および GradientDirection プロパティとともに呼び出されます。
カテゴリ パネル グループの HeaderStyle プロパティが hsThemed に設定されている場合、ACanvas はこのカテゴリ パネルの ClientRect で指定されている四角形内の、このカテゴリ パネル インスタンスの Color で塗ります。その後、キャンバスは Windows DrawThemeBackground プロシージャに渡されます。
カテゴリ パネル グループの HeaderStyle プロパティが hsImageに設定され、また、カテゴリ パネル グループの HeaderImage プロパティに画像が入っている場合、キャンバスの StretchDraw プロシージャを使って、ClientRect にその画像が描画されます。HeaderImage が空の場合、GradientFillCanvas が呼び出されます。
DrawHeaderBackground は protected メソッドなので、拡張クラスの TCustomCategoryPanel の実装の中からのみ呼び出すことができます。