Vcl.ExtCtrls.TCustomCategoryPanel.DrawHeaderBackground
Delphi
procedure DrawHeaderBackground(ACanvas: TCanvas); virtual;
C++
virtual void __fastcall DrawHeaderBackground(Vcl::Graphics::TCanvas* ACanvas);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
protected | Vcl.ExtCtrls.pas Vcl.ExtCtrls.hpp |
Vcl.ExtCtrls | TCustomCategoryPanel |
Description
Dessine l'arrière-plan de l'en-tête du panneau catégorie.
Utilisez DrawHeaderBackground pour dessiner l'arrière-plan du panneau catégorie selon les propriétés du groupe de panneaux catégorie parent. Le paramètre ACanvas nécessite une instance de TCanvas créée avec le contexte de périphérique de la fenêtre, assigné à la propriété Handle du canevas. Cette instance de canevas doit être libérée après l'appel de DrawHeaderBackground.
Le rectangle dessiné par DrawHeaderBackground est spécifié dans le ClientRect de ce contrôle avec le bas du rectangle défini sur le HeaderHeight. L'en-tête est dessiné selon les propriétés du groupe parent du panneau catégorie.
Si la propriété HeaderStyle du groupe de panneaux catégorie est définie sur hsGradient, la fonction GradientFillCanvas de GraphUtil est ensuite appelée avec les propriétés GradientBaseColor, GradientColor et GradientDirection du groupe de panneaux catégorie.
Si la propriété HeaderStyle du groupe de panneaux catégorie est définie sur hsThemed, le ACanvas est alors rempli par la Color de cette instance de panneau catégorie dans le rectangle spécifié par le ClientRect de ce panneau catégorie. Le canevas est ensuite passé à la procédure DrawThemeBackground de Windows.
Si la propriété HeaderStyle du groupe de panneaux catégorie est définie sur hsImage, et si la propriété HeaderImage du groupe de panneaux catégorie contient une image, l'image est alors dessinée dans le ClientRect par la procédure StretchDraw du canevas. Si le HeaderImage est vide, GradientFillCanvas est alors appelé.
DrawHeaderBackground est une méthode protégée et peut ainsi seulement être appelée dans l'implémentation d'une classe étendue de TCustomCategoryPanel.