Comment : Récupérez les descriptions de champ de la fenêtre Propriétés
En bas de la fenêtre de Propriétés , une zone de description affiche des informations relatives au champ sélectionné. Cette fonctionnalité est activée par défaut. Si vous souhaitez masquer le champ de description, cliquez avec le bouton droit sur la fenêtre du Propriétés et cliquez sur Description. Faire il supprime également la case à cocher en regard de le titre de Description dans la fenêtre de menu. Vous pouvez consulter le champ de nouveau en suivant les mêmes étapes pour basculer en arrière de Description sur.
Les informations dans le champ de description qui proviennent d' ITypeInfo. Chaque méthode, interface, coclasse, etc. peut avoir un attribut localisé d' helpstring dans la bibliothèque de types. la fenêtre de Propriétés extrait la chaîne de l' GetDocumentation.
Pour spécifier les chaînes localisées d'aide
ajoutez l'attribut d' helpstringdll à l'instruction de bibliothèque à la bibliothèque de types (typelib).
Notes
Cette étape est facultative si la bibliothèque de types est dans un fichier de bibliothèque d'objets (.olb).
spécifiez les attributs d' helpstringcontext pour les chaînes. vous pouvez également spécifier des attributs d' helpstring .
Ces attributs sont distincts des attributs d' helpfile et d' helpcontext , qui figurent dans les rubriques d'aide réelles de fichier .chm.
Pour récupérer des informations de description à afficher pour le nom de la propriété en surbrillance, la fenêtre de Propriétés appelle l' GetDocumentation2 pour la propriété qui est sélectionnée, en spécifiant l'attribut souhaité d' lcid pour la chaîne de sortie. en interne, ITypeInfo2 recherche le fichier.DLL spécifié dans l'attribut d' helpstringdll et appelle DLLGetDocumentation sur ce fichier.DLL avec le contexte et l'attribut spécifiés d' lcid .
la signature et l'implémentation d' DLLGetDocumentation sont :
STDAPI DLLGetDocumentation
(
ITypeLib * /* ptlib */,
ITypeInfo * /* ptinfo */,
LCID /* lcid */,
DWORD dwCtx,
BSTR * pbstrHelpString
);
La fonction d' DLLGetDocumentation doit être une exportation définie dans le fichier .def de la DLL.
En interne, il crée un fichier de .olb qui est réellement une DLL. Cette DLL contient une ressource, le fichier bibliothèque de types (.tlb), et une fonction exportée, DLLGetDocumentation.
Dans le cas de les fichiers .olb, l'attribut d' helpstringdll est facultatif car il s'agit du même fichier qui contient le fichier .tlb lui-même.
Pour obtenir des chaînes d'apparaître dans le volet de descriptions , par conséquent, le minimum que vous avez à faire est de spécifier l'attribut pour helpstring dans la bibliothèque de types. Si vous souhaitez que ces chaînes à localiser, vous devez spécifier l'attribut (facultatif) d' helpstringdll et l'attribut d' helpstringcontext (obligatoire) et implémenter DLLGetDocumentation.
Il n'existe aucune interface supplémentaire qui doit être implémentée en obtenant les informations localisées à travers l'attribut et l' DLLGetDocumentationd' helpstringcontext des IDL (interface definition langage).
Une autre façon d'obtenir le nom et la description localisés d'une propriété est en implémentant l' GetLocalizedPropertyInfo. Pour plus d'informations sur l'implémentation de cette méthode, consultez Champs et interfaces de fenêtre Propriétés.
Voir aussi
Référence
Concepts
Champs et interfaces de fenêtre Propriétés