Vcl.ExtCtrls.TCustomCategoryPanel.DrawHeaderCaption

Übergeordnet: TCustomCategoryPanel

Delphi

procedure DrawHeaderCaption(ACanvas: TCanvas); virtual;

C++

virtual void __fastcall DrawHeaderCaption(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 Titel der Kopfleiste des Kategorienbereichs.

Mit DrawHeaderCaption zeichnen Sie den Titel 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 DrawHeaderCaption freigegeben werden.

Die verwendete Schriftart wird in der Eigenschaft HeaderFont des der Kategorienbereichsgruppe übergeordneten Elements angegeben. Der Titel wird anhand der Eigenschaft Alignment des Kategorienbereichs und der Einstellungen der Text-Flags der Eigenschaft BiDiMode der Zeichenfläche gezeichnet.

Wenn die Eigenschaft HeaderStyle der Kategorienbereichsgruppe auf hsThemed gesetzt ist, und Themes aktiviert sind, wird der Titel vom Theme-Service der Funktion DrawText gezeichnet. Ansonsten wird der Titel mit der Windows-API-Funktion DrawText gezeichnet.

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