Contrôles ActiveX MFC : peinture d'un contrôle ActiveX

Cet article décrit le processus de peinture du contrôle ActiveX et le mode de modification du code de peinture pour optimiser le processus. (Voir Optimisation du dessin de contrôle pour les techniques permettant d’optimiser le dessin en n’ayant pas de contrôles individuellement restaurer des objets GDI précédemment sélectionnés. Une fois que tous les contrôles ont été dessinés, le conteneur peut restaurer automatiquement les objets d’origine.)

Les exemples dans cet article proviennent d'un contrôle créé par l'Assistant Contrôle ActiveX de MFC avec des paramètres par défaut. Pour plus d’informations sur la création d’une application de contrôle squelette à l’aide de l’Assistant Contrôle ActiveX MFC, consultez l’article MFC ActiveX Control Wizard.

Les rubriques suivantes sont traitées :

• Processus global de peinture d’un contrôle et du code créé par l’Assistant Contrôle ActiveX pour prendre en charge la peinture

• Comment optimiser le processus de peinture

• Comment peindre votre contrôle à l’aide de métafichiers

Processus de peinture d’un contrôle ActiveX

Lorsque les contrôles ActiveX sont initialement affichés ou redessinés, ils suivent un processus de peinture semblable à d'autres applications développées à l'aide de MFC, avec une distinction importante : les contrôles ActiveX peuvent être dans un état actif ou inactif.

Un contrôle actif est représenté dans un conteneur de contrôles ActiveX par une fenêtre enfant. Comme d’autres fenêtres, il est responsable de la peinture elle-même lorsqu’un message WM_PAINT est reçu. La classe de base du contrôle, COleControl, gère ce message dans sa OnPaint fonction. Cette implémentation par défaut appelle la fonction OnDraw de votre contrôle.

Un contrôle inactif est peint différemment. Lorsque le contrôle est inactif, sa fenêtre est invisible ou inexistante, donc il ne peut pas recevoir de message de peinture. En revanche, le conteneur de contrôle appelle directement la fonction OnDraw du contrôle. Ceci diffère du processus de peinture actif d'un contrôle en ce que la fonction membre OnPaint n'est jamais appelée.

Comme décrit dans les paragraphes précédents, la manière dont un contrôle ActiveX est mis à jour dépend de l'état du contrôle. Toutefois, étant donné que le framework appelle la fonction membre OnDraw dans les deux cas, vous ajoutez la majorité de votre code de peinture dans cette fonction membre.

La fonction membre OnDraw gère la peinture du contrôle. Lorsqu'un contrôle est inactif, le conteneur de contrôle appelle OnDraw, en passant le contexte de périphérique du conteneur de contrôle et les coordonnées de la zone rectangulaire occupée par le contrôle.

Le rectangle passé par le framework à la fonction membre OnDraw contient la zone occupée par le contrôle. Si le contrôle est actif, l'angle supérieur gauche est (0, 0) et le contexte de périphérique est passé pour la fenêtre enfant qui contient le contrôle. Si le contrôle est inactif, la coordonnée supérieure gauche n'est pas nécessairement égale à 0, 0 et le contexte de périphérique est passé pour le conteneur de contrôle qui contient le contrôle.

L'implémentation par défaut fournie par l'Assistant Contrôle ActiveX MFC dans le fichier d'implémentation du contrôle (.CPP), comme indiqué ci-dessous, peint le rectangle avec un pinceau blanc et remplit l'ellipse avec la couleur d'arrière-plan actuelle.

void CMyAxUICtrl::OnDraw(CDC* pdc, const CRect& rcBounds, const CRect& /*rcInvalid*/)
{
   if (!pdc)
      return;

   // TODO: Replace the following code with your own drawing code.
   pdc->FillRect(rcBounds, CBrush::FromHandle((HBRUSH)GetStockObject(WHITE_BRUSH)));
   pdc->Ellipse(rcBounds);
}

Optimisation de votre code de peinture

Lorsque le contrôle se peint avec succès, l'étape suivante consiste à optimiser la fonction OnDraw.

L'implémentation par défaut du contrôle de peinture ActiveX peint la zone de contrôle entière. Ceci suffit pour les contrôles simples, mais dans de nombreux cas, redessiner le contrôle serait plus rapide si seulement la partie qui nécessitait une mise à jour était repeinte, au lieu du contrôle entier.

La OnDraw fonction fournit une méthode simple d’optimisation en passant rcInvalid, zone rectangulaire du contrôle qui a besoin de redessiner. Utilisez cette zone, généralement inférieure à la zone de contrôle entière, pour accélérer le processus de peinture.

Peinture de votre contrôle à l’aide de métafichiers

Dans la plupart des cas, le paramètre pdc vers la OnDraw fonction pointe vers un contexte d’appareil d’écran (DC). Toutefois, lors de l'impression d'images du contrôle ou lors d'une session d'aperçu avant impression, le contrôleur de domaine reçu pour affichage est un type spécial appelé "contexte de périphérique de métafichier". Contrairement à un écran contrôleur de domaine, qui gère à la fois les demandes qui lui sont envoyées, les métafichiers DC stocke les demandes qui doivent être traitées ultérieurement. Certaines applications conteneur peuvent également choisir d'afficher l'image de contrôle lorsqu'il se trouve en mode création à l'aide d'un métafichier DC.

Les requêtes de dessin de métafichier peuvent être effectuées par le conteneur via deux fonctions d’interface : IViewObject::Draw (cette fonction peut également être appelée pour le dessin non métafichier) et IDataObject::GetData. Lorsqu’un contrôleur de domaine de métafichier est passé en tant que l’un des paramètres, l’infrastructure MFC effectue un appel à COleControl ::OnDrawMetafile. Puisqu'il s'agit d'une fonction membre virtuelle, remplacez cette fonction dans la classe de contrôle pour effectuer tout traitement spécial. Le comportement par défaut appelle COleControl::OnDraw.

Pour garantir que le contrôle peut être dessiné à la fois sur l'écran et sur des contextes de périphérique de métafichier, vous ne devez utiliser que les fonctions membres qui sont prises en charge à la fois dans un écran et dans un contexte de périphérique de métafichier. Sachez que le système de coordonnées peut ne pas être exprimé en pixels.

Etant donné que l'implémentation par défaut de OnDrawMetafile appelle la fonction OnDraw du contrôle, n'utilisez que les fonctions membres qui conviennent à la fois pour un métafichier et pour un contexte de périphérique, sauf si vous remplacez OnDrawMetafile. Ce qui suit répertorie le sous-ensemble de fonctions membres CDC qui peuvent être utilisées à la fois dans un métafichier et dans écran de contexte de périphérique. Pour plus d’informations sur ces fonctions, consultez la capture de données modifiées de classe dans la référence MFC.

Outre les fonctions membres CDC, il existe plusieurs autres fonctions compatibles dans un contexte de périphérique de métafichier. Il s’agit notamment de CPalette ::AnimatePalette, CFont ::CreateFontIndirect et trois fonctions membres de CBrush: CreateBrushIndirect, CreateDIBPatternBrush et CreatePatternBrush.

Les fonctions qui ne sont pas enregistrées dans un métafichier sont : DrawFocusRect, DrawIcon, DrawText, ExcludeUpdateRgn, FillRect, FrameRect, GrayString, InvertRect, ScrollDC et TabbedTextOut. Étant donné qu'un contexte de périphérique de métafichier n'est pas réellement associé à un périphérique, vous ne pouvez pas utiliser SetDIBits, GetDIBits et CreateDIBitmap avec un contexte de périphérique de métafichier. Vous pouvez utiliser SetDIBitsToDevice et StretchDIBits avec un contexte de périphérique de métafichier comme destination. CreateCompatibleDC, CreateCompatibleBitmap et CreateDis carte ableBitmap ne sont pas significatifs avec un contrôleur de domaine de métafichier.

Un autre point à prendre en considération lors de l'utilisation d'un contexte de périphérique de métafichier est que le système de coordonnées peut ne pas être exprimé en pixels. Pour cette raison, tout votre code de dessin doit être ajusté pour s’adapter au rectangle passé dans OnDraw le paramètre rcBounds . Cela empêche la peinture accidentelle en dehors du contrôle, car rcBounds représente la taille de la fenêtre du contrôle.

Une fois que vous avez implémenté le rendu de métafichier pour le contrôle, utilisez le contrôleur de test pour tester le métafichier. Pour plus d’informations sur la façon d’accéder au conteneur de test, consultez la page Test des propriétés et des événements avec le conteneur de test .

Pour tester le métafichier du contrôle à l'aide du Contrôleur de test

1. Dans le menu Modifier du conteneur de test, cliquez sur Insérer un nouveau contrôle.

2. Dans la zone Insérer un nouveau contrôle , sélectionnez le contrôle, puis cliquez sur OK.

   Le contrôle s'affiche dans le conteneur de test.

3. Dans le menu Contrôle , cliquez sur Dessiner un métafichier.

   Une fenêtre distincte apparaît dans laquelle le métafichier s'affiche. Vous pouvez modifier la taille de cette fenêtre pour voir comment la mise à l'échelle affecte un métafichier du contrôle. Vous pouvez fermer cette fenêtre à tout moment.

Voir aussi

Contrôles ActiveX MFC