Contrôles ActiveX sur Internet

Article
06/10/2015

Les contrôles ActiveX sont la version mise à jour de la spécification de contrôle OLE. Les contrôles sont une architecture primaire pour le développement de composants logiciels programmables qui peuvent être utilisés dans plusieurs conteneurs, y compris les navigateurs Web COM-compatibles sur Internet. Un contrôle ActiveX peut être un contrôle Internet et peut ajouter ses fonctionnalités dans un document actif ou faire partie d'une page Web. Les contrôles sur une page Web peuvent communiquer entre eux à l'aide de scripts.

Les contrôles ActiveX ne sont pas limités à Internet. Un contrôle ActiveX peut également être utilisé dans n'importe quel conteneur, tant que le contrôle prend en charge les interfaces requises par ce conteneur.

Les contrôles ActiveX ont plusieurs avantages, notamment :

Moins d'interfaces requises que les contrôles OLE précédents.
La possibilité d'être sans fenêtre et toujours actif sur place.

Pour être un contrôle ActiveX, un contrôle doit :

Prend en charge l'interface IUnknown.
Etre un Objet COM
Exporter DLLRegisterServer et DLLUnRegisterServer.
Supporter des interfaces additionnelles, comme requis par la fonctionnalité.

Rendre vos contrôles existants adaptés à Internet

Concevoir un contrôle qui fonctionne bien dans un environnement Internet nécessite de faire attention aux débits de transmission relativement faibles sur Internet. Vous pouvez utiliser les contrôles existants ; toutefois, il existe des étapes que vous devez effectuer pour rendre le nombre d'instructions plus petit et pour effectuer vos téléchargements de propriétés du contrôle de manière asynchrone.

Pour améliorer les performances des contrôles, suivez ces conseils sur les considérations relatives à l'efficacité :

Implémentez les techniques décrites dans l'article Contrôles ActiveX : Optimisation.
Déterminez comment un contrôle est instancié.
Soyez asynchrone ; ne retardez pas d'autres programmes.
Téléchargez les données par petits blocs.

En téléchargeant des flux de données tels que des fichiers bitmap ou des données vidéo, accédez aux données d'un contrôle en coopération avec le conteneur. Récupérez des données de façon incrémentielle ou progressive, en travaillant en coopération avec d'autres contrôles qui peuvent aussi réupérer des données. Ce code peut également télécharger de manière asynchrone.
Téléchargez le code et les propriétés en arrière-plan.
Soyez aussi actif que possible au niveau de l'interface utilisateur.
Considérez la manière dont les données permanentes sont enregistrées, à la fois pour les propriétés et les grosses données BLOB (par exemple une image bitmap ou des données vidéo).

Les contrôles avec des quantités importantes de données permanentes, telles que des fichiers bitmap ou AVI, requièrent une attention particulière à la méthode de téléchargement. Un document ou une page peut être visible dès que possible, et permet à l'utilisateur d'interagir avec la page lorsque les contrôles extraient des données en arrière-plan.
Entrez les routines efficaces pour réduire le nombre et l'exécution d'instructions.

Les contrôles d'étiquette et de petits boutons, avec seulement quelques octets de données persistantes, conviennent pour une utilisation dans l'environnement Internet et fonctionnent correctement à l'intérieur des navigateurs.
Considérez que la progression est communiquée au conteneur.

Informez le conteneur de la progression du téléchargement asynchrone, notamment lorsque l'utilisateur peut commencer à interagir avec une page, et si le téléchargement terminé. Le conteneur peut afficher la progression (tels que les pourcentages complétés) à l'utilisateur.
Déterminez comment les contrôles sont stockés sur l'ordinateur client.

Création d'un nouveau contrôle ActiveX

Lors de la création d'un contrôle avec l'Assistant d'Application, vous pouvez choisir d'activer la prise en charge des monikers asynchrones ainsi que des optimisations supplémentaires. Pour ajouter la prise en charge des propriétés de téléchargement asynchrone, procédez comme suit :

Pour créer votre projet à l'aide de l'Assistant de Contrôle ActiveX MFC

Cliquez sur New dans le menu Fichier.
Sélectionnez Assistant Contrôle ActiveX MFC dans les projets Visual C++ et nommez votre projet.
Dans la page Paramètres du contrôle, sélectionnez Charge les propriétés de façon asynchrone. Cette option configure la propriété d'état prêt et l'événement de modification d'état prêt pour vous.

Vous pouvez également sélectionner des optimisations supplémentaires, telles que Activation sans fenêtre, décrit dans Contrôles ActiveX : Optimisation.
Cliquez sur Terminer pour créer le projet.

Pour créer une classe dérivée de CDataPathProperty

Créez une classe dérivée de CDataPathProperty.
Dans chacun de vos fichiers sources qui contiennent le fichier d'en-tête pour le contrôle, ajoutez le fichier d'en-tête pour cette classe avant celui-ci.

Dans cette classe, remplacez OnDataAvailable. Cette fonction est appelée lorsque les données sont disponibles pour l'affichage. Lorsque des données deviennent disponibles, vous pouvez les gérer avec la méthode de votre choix, par exemple avec un affichage progressif.

L'extrait de code ci-dessous est un exemple simple d'affichage progressif des données dans un contrôle d'édition. Notez l'utilisation de l'indicateur BSCF_FIRSTDATANOTIFICATION pour désactiver le contrôle d'édition.

void CMyDataPathProperty::OnDataAvailable(DWORD dwSize, DWORD bscfFlag)
{
    CListCtrl list_ctrl;
    CEdit* edit = list_ctrl.GetEditControl();
    if ((bscfFlag & BSCF_FIRSTDATANOTIFICATION) && edit->m_hWnd)
    {
        edit->SetSel(0, -1);
        edit->Clear();
    }

   if (dwSize > 0)
   {
      CString string;
      LPTSTR str = string.GetBuffer(dwSize);
      UINT nBytesRead = Read(str, dwSize);
      if (nBytesRead > 0)
      {
         string.ReleaseBuffer(nBytesRead);
         edit->SetSel(-1, -1);
         edit->ReplaceSel(string);
      }
   }
}

Notez que vous devez inclure AFXCMN.H pour utiliser la classe CListCtrl.

Lorsque votre contrôle change d'état général (par exemple, de "en chargement" à "initialisé" ou "en intéraction utilisateur"), appelez COleControl::InternalSetReadyState. Si le contrôle a une seule propriété de chemin d'accès aux données, vous pouvez ajouter du code dans BSCF_LASTDATANOTIFICATION pour notifier le conteneur que le téléchargement est terminé. Par exemple :
```
if (bscfFlag & BSCF_LASTDATANOTIFICATION)
{
   GetControl()->InternalSetReadyState(READYSTATE_COMPLETE);
}
```
Override OnProgress. Dans OnProgress, il vous est renvoyé un nombre qui indique la plage maximale et un nombre indiquant l'avancement du téléchargement actuel. Vous pouvez utiliser ces nombres pour afficher l'état, comme le pourcentage de complétion.

La procédure suivante ajoute une propriété au contrôle pour utiliser uniquement la classe qui vient d'être dérivée.

Pour ajouter une propriété

Dans Affichage de classes, cliquez avec le bouton droit sur l'interface sous le nœud de bibliothèque et sélectionnez Ajouter, puis Ajouter une propriété. Cela démarre Assistant Ajout de propriété.
Dans Assistant Ajout de propriété, sélectionnez la case d'option de Set/Get Methods, tapez Nom de propriété, par exemple, EditControlText, puis sélectionnez BSTR comme Type de propriété.
Cliquez sur Terminer.
Déclarez une variable membre de votre classe dérivée de CDataPathProperty à votre classe de contrôles ActiveX.
```
CMyDataPathProperty EditControlText;
```

Implémentez les méthodes Get/Set. Pour Get, renvoyez la chaîne. Pour Set, chargez la propriété et appelez SetModifiedFlag.

BSTR CMFCActiveXControlCtrl::GetEditControlText(void)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   CString strResult;
   strResult = EditControlText.GetPath();   
   return strResult.AllocSysString();
}

void CMFCActiveXControlCtrl::SetEditControlText(LPCTSTR newVal)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   Load(newVal, EditControlText);
   SetModifiedFlag();
}

Dans DoPropExchange, ajoutez la ligne suivante :

PX_DataPath(pPX, _T("DataPath"), EditControlText);

Substituez ResetData pour notifier la propriété de réinitialiser son contrôle en ajoutant cette ligne :
```
EditControlText.ResetData();
```

Choisir partir de CDataPathProperty ou de CCachedDataPathProperty

L'exemple précédent décrit les étapes pour dériver la propriété de votre contrôle de CDataPathProperty. Il s'agit d'un bon choix si vous téléchargez des données en temps réel qui changent fréquemment, et pour lesquelles vous n'avez pas besoin de conserver toutes les données, mais uniquement la valeur actuelle. Un exemple est un contrôle ticker standard.

Vous pouvez également dériver CCachedDataPathProperty. Dans ce cas, les données téléchargées sont mises en cache dans un fichier de stockage. Il s'agit d'un bon choix si vous devez conserver toutes les données téléchargées (par exemple, un contrôle qui affiche progressivement une bitmap). Dans ce cas, la classe possède une variable membre contenant les données :

CMemFile m_Cache;

Dans la classe de contrôle ActiveX, vous pouvez utiliser ce fichier mappé en mémoire dans OnDraw pour afficher les données. Dans votre classe contrôle ActiveX dérivée CCachedDataPathProperty, substituez la fonction membre OnDataAvailable et infirmez le contrôle, après avoir appelé l'implémentation de la classe de base.

void CMyCachedDataPathProperty::OnDataAvailable(DWORD dwSize, DWORD bscfFlag)
{
   CCachedDataPathProperty::OnDataAvailable(dwSize, bscfFlag);
   GetControl()->InvalidateControl();
}

Téléharger des donner en mode asynchrone à l'aide de les contrôles ActiveX

Les données de téléchargement sur un réseau doivent être effectuées de manière asynchrone. L'avantage de cette opération est que si un grand nombre de données sont transférées ou si la connexion est lente, l'opération de téléchargement ne bloque pas d'autres processus exécutés sur le client.

Des monikers asynchrones permettent de télécharger les données asynchrone sur un réseau. Une opération de lecture dans un moniker asynchrone retourne immédiatement le résultat, même si l'opération n'a pas été effectuée.

Par exemple, si seuls 10 octets sont disponibles et la lecture est appelée de manière asynchrone dans un fichier 1K, la lecture ne bloque pas, mais retourne les 10 octets disponibles.

Vous implémentez monikers asynchrones en utilisant la classe CAsyncMonikerFile. Toutefois, les contrôles ActiveX peuvent utiliser la classe CDataPathProperty, dérivée de CAsyncMonikerFile, pour implémenter des propriétés du contrôle asynchrones.

L'exemple de ASYNDOWN montre comment configurer une boucle asynchrone en utilisant des timers pour lire les données. ASYNDOWN est décrit en détail dans l'article de la Base de connaissances « HOWTO : AsyncDown illustre le téléchargement asynchrone de données » (Q177244) et peut être téléchargé à partir du Centre de téléchargement Microsoft. (Pour plus d'informations sur le téléchargement classe à partir de le Centre de téléchargement Microsoft, consultez l'article « comment obtenir des fichiers de support technique Microsoft depuis les services en ligne » (Q119591) dans la Base de connaissances Microsoft.) Vous trouverez les articles de Base de connaissances sur le CD-ROM de la bibliothèque MSDN ou à l'adresse https://support.microsoft.com/support.

La technique de base utilisée dans ASYNDOWN consiste à définir une horloge dans CDataPathProperty::OnDataAvailable pour montrer quand les données sont disponibles. Si le message du minuteur est accepté, elle lit dans des blocs de 128 octets de données et remplit un contrôle d'édition. Si les données ne sont pas disponibles lorsque le message du minuteur est traité, le minuteur est désactivé. OnDataAvailable démarre l'horloge si plus de données arrivent ultérieurement.

Afficher un contrôle dans une page Web

Voici un exemple de tag et d'attributs d'objet pour insérer un contrôle dans une page Web.

<OBJECT

CLASSID="clsid:FC25B780-75BE-11CF-8B01-444553540000"

CODEBASE="/ie/download/activex/iechart.ocx"

ID=chart1

WIDTH=400

HEIGHT=200

ALIGN=center

HSPACE=0

VSPACE=0

</OBJECT>

Mettre à jour un contrôle OLE existant pour utiliser les nouvelles fonctionnalités du contrôle ActiveX

Si votre contrôle utilisateur a été créé avec une version de Visual C++ antérieure à 4.2, il existe des étapes que vous pouvez suivre pour améliorer ses performances et ses fonctionnalités. Pour une présentation détaillée de ces modifications, consultez Contrôles ActiveX : Optimisation.

Si vous ajoutez la prise en charge des propriétés asynchrones à un contrôle existant, vous devez ajouter la propriété d'état prêt et l'événement de ReadyStateChange vous-même. Dans le constructeur de votre contrôle, ajoutez :

m_lReadyState = READYSTATE_LOADING;

Vous allez mettre à jour l'état prêt tandis que votre code est téléchargé en appelant COleControl::InternalSetReadyState. Un emplacement que vous pouvez appeler InternalSetReadyState est de la substitution de OnProgress de classe dérivée de CDataPathProperty.

Ensuite, suivez les étapes dans Création d'un contrôle ActiveX.

Voir aussi

Concepts

Tâches de programmation Internet MFC

Concepts de programmation Internet MFC

Partager via