IStringDisplayableConcept::ToDisplayString-Methode (dbgmodel.h)
Die ToDisplayString-Methode wird immer dann aufgerufen, wenn ein Client ein Objekt in eine anzuzeigende Zeichenfolge konvertieren möchte (in der Konsole, auf der Benutzeroberfläche usw.). Eine solche Zeichenfolgenkonvertierung sollte nicht für die Grundlage zusätzlicher programmgesteuerter Manipulationen verwendet werden. Die Zeichenfolgenkonvertierung selbst kann stark von den Metadaten beeinflusst werden, die an den Aufruf übergeben werden. Eine Zeichenfolgenkonvertierung sollte jeden Versuch unternehmen, die Schlüssel PreferredRadix und PreferredFormat zu berücksichtigen.
Syntax
HRESULT ToDisplayString(
IModelObject *contextObject,
IKeyStore *metadata,
BSTR *displayString
);
Parameter
contextObject
Der instance (dieser Zeiger), der in eine Anzeigezeichenfolge konvertiert wird, wird in diesem Argument übergeben.
metadata
Ein optionaler Metadatenspeicher, der definiert, wie die Zeichenfolge vom Aufrufer konvertiert werden soll. Die Implementierung sollte jeden Versuch unternehmen, die Anforderungen im Store (insbesondere die Schlüssel PreferredRadix und PreferredFormat) zu erfüllen.
displayString
Die von der SysAllocString-Funktion zugewiesene Zeichenfolgenkonvertierung wird hier zurückgegeben.
Rückgabewert
Diese Methode gibt HRESULT zurück, was auf Erfolg oder Fehler hinweist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |