Vcl.ExtCtrls.TCustomCategoryPanel.DrawHeaderBackground

Übergeordnet: TCustomCategoryPanel

Delphi

procedure DrawHeaderBackground(ACanvas: TCanvas); virtual;

C++

virtual void __fastcall DrawHeaderBackground(Vcl::Graphics::TCanvas* ACanvas);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	protected	Vcl.ExtCtrls.pas Vcl.ExtCtrls.hpp	Vcl.ExtCtrls	TCustomCategoryPanel

Beschreibung

Zeichnet den Hintergrund der Kopfleiste des Kategorienbereichs.

Mit DrawHeaderBackground zeichnen Sie den Hintergrund des Kategorienbereichs entsprechend der Eigenschaften der übergeordneten Kategorienbereichsgruppe. Der Parameter ACanvas benötigt eine mit dem Gerätekontext des Fensters erstellte TCanvas-Instanz. Der Gerätekontext wird der Eigenschaft Handle der Zeichenfläche zugewiesen. Diese Zeichenflächeninstanz sollte nach dem Aufruf von DrawHeaderBackground freigegeben werden.

Das von DrawHeaderBackground gezeichnete Rechteck ist im ClientRect dieses Steuerelements angegeben, wobei die untere Kante des Rechtecks auf HeaderHeight gesetzt ist. Die Kopfleiste wird entsprechend der Eigenschaften des der Kategorienbereichsgruppe übergeordneten Elements gezeichnet.

Wenn die Eigenschaft HeaderStyle der Kategorienbereichsgruppe auf hsGradient gesetzt ist, wird die GraphUtil-Funktion GradientFillCanvas mit den Eigenschaften GradientBaseColor, GradientColor und GradientDirection der Kategorienbereichsgruppe aufgerufen.

Wenn die Eigenschaft HeaderStyle auf hsThemed gesetzt ist, wird ACanvas mit der Farbe (Color) dieser Kategorienbereichsinstanz in dem in ClientRect dieses Kategorienbereichs angegebenen Rechteck gefüllt. Die Zeichenfläche wird dann an die Windows-Prozedur DrawThemeBackground übergeben.

Wenn die Eigenschaft HeaderStyle auf hsImage gesetzt ist, und die Eigenschaft HeaderImage der Kategorienbereichsgruppe ein Bild enthält, dann wird das Bild in ClientRect mit der Zeichenflächenprozedur StretchDraw gezeichnet. Wenn HeaderImage leer ist, dann wird GradientFillCanvas aufgerufen.

DrawHeaderBackground ist eine protected Methode und kann daher nur in der Implementierung einer erweiterten Klasse von TCustomCategoryPanel aufgerufen werden.