IStringDisplayableConcept ::ToDisplayString, méthode (dbgmodel.h)
La méthode ToDisplayString est appelée chaque fois qu’un client souhaite convertir un objet en chaîne à afficher (dans la console, dans l’interface utilisateur, etc.). Une telle conversion de chaîne ne doit pas être utilisée pour la base d’une manipulation programmatique supplémentaire. La conversion de chaîne elle-même peut être profondément influencée par les métadonnées passées à l’appel. Une conversion de chaîne doit effectuer chaque tentative d’honorer les clés PreferredRadix et PreferredFormat.
Syntaxe
HRESULT ToDisplayString(
IModelObject *contextObject,
IKeyStore *metadata,
BSTR *displayString
);
Paramètres
contextObject
L’instance (ce pointeur) convertie en chaîne d’affichage est passée dans cet argument.
metadata
Magasin de métadonnées facultatif qui définit la façon dont l’appelant souhaite la conversion de la chaîne. L’implémentation doit effectuer chaque tentative d’honorer les demandes dans le magasin (notamment les clés PreferredRadix et PreferredFormat).
displayString
La conversion de chaînes telle qu’allouée par la fonction SysAllocString est retournée ici.
Valeur de retour
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Exigences
Exigence | Valeur |
---|---|
d’en-tête | dbgmodel.h |