Informations du Registre des contrôles ActiveX

Il existe un certain nombre d’entrées et d’indicateurs de Registre utilisés. En outre, les contrôles peuvent prendre en charge les catégories de composants pour classifier les fonctionnalités qu’ils fournissent.

Les clés de Registre associées aux contrôles sont marquées avec un astérisque dans l’arborescence suivante :

HKEY_CLASSES_ROOT
   CLSID
      {control_CLSID}
         ProgID = <identifier>
         InprocServer32 = <filename>.dll
         *DefaultIcon = <filename>.<ext>,resourceID
         *ToolboxBitmap32 = <filename>.<ext>,resourceID
         *Control
         verb
            *n = &Properties...
         *MiscStatus = 0
         TypeLib = {object_typelibID}
         *Version = version_number

L’entrée DefaultIcon est utilisée pour identifier une icône à afficher lorsque le contrôle est réduit à une icône. La fonction ExtractIcon est utilisée pour obtenir l’icône à partir du fichier .DLL ou .EXE spécifié.

L’entrée ToolboxBitmap32 identifie le nom du module et l’identificateur de ressource d’une bitmap 16*15 à utiliser pour le visage d’une barre d’outils ou d’un bouton de boîte à outils. La taille d’icône Windows standard est trop grande pour être utilisée à cet effet. Cette entrée prend spécifiquement en charge les conteneurs de contrôle qui ont un mode de conception dans lequel l’un sélectionne les contrôles et les place sur un formulaire en cours de conception. Par exemple, dans Visual Basic, l’icône du contrôle s’affiche dans la boîte à outils Visual Basic pendant le mode création.

L’entrée Control marque un objet en tant que contrôle. Cette entrée est souvent utilisée par les conteneurs pour remplir les boîtes de dialogue. Le conteneur utilise cette sous-clé pour déterminer s’il faut inclure un objet dans une boîte de dialogue qui affiche les contrôles.

La sous-clé insère peut également être utilisée avec des contrôles, selon que l’objet ne peut agir qu’en tant qu’objet incorporé sur place sans fonctionnalités de contrôle spéciales. Les objets marqués avec insérables s’affichent dans la boîte de dialogue Insérer un objet de leur conteneur. L’entrée insère signifie généralement que le contrôle a été testé avec des conteneurs non-contrôle.

Les sous-clés insèreables et contrôle sont facultatifs. Un contrôle peut omettre la sous-clé insère si elle n’est pas conçue pour fonctionner avec des conteneurs plus anciens qui ne comprennent pas les contrôles. Un contrôle peut omettre la clé de contrôle si elle est conçue uniquement pour fonctionner avec un conteneur spécifique et ne souhaite donc pas être insérée dans d’autres conteneurs.

Les contrôles doivent avoir un PropertiesverbOLEIVERB_PROPERTIES, ainsi que d’autres verbes qu’ils prennent en charge. Le Propertiesverbcontrôle, ainsi que le OLEIVERB_PRIMARY standard verb , indique au contrôle d’afficher sa feuille de propriétés. L’élément Propertiesverb est affiché en tant qu’élément dans le Properties menu du conteneur lorsque le contrôle est actif. De cette façon, le contrôle peut afficher sa propre page de propriétés, ce qui permet d’utiliser certaines fonctionnalités utiles à l’utilisateur final, même si le conteneur ne gère pas les contrôles.

Un contrôle définit la clé MiscStatus pour se décrire à des conteneurs potentiels. Les bits prennent les valeurs de OLEMISC, et les contrôles ajoutent plusieurs valeurs à cette énumération. Pour plus d’informations, consultez les valeurs d’énumération OLEMISC. Le client peut obtenir ces informations en appelant IOleObject ::GetMiscStatus sans avoir à instancier le contrôle en premier.

Enfin, version décrit la version du contrôle qui doit correspondre à la version de la bibliothèque de types associée à ce contrôle.

En outre, dans les informations de type d’un contrôle, le contrôle d’attribut marque une entrée de coclasse comme décrivant un contrôle.