IDkmCustomVisualizer Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Diese Schnittstelle wird durch benutzerdefinierte Ausdrucks auswertervisualisierungen implementiert, um die Ansicht eines Ausdrucks Programm gesteuert anzupassen. Dies geschieht normalerweise, um Visualisierungen zu unterstützen, die mithilfe der systemeigenen Schnellansicht-Syntax nicht möglich sind, oder um die Visualisierung ohne vollständige symbolische Informationen zu aktivieren. Die Schnellansicht kann die gesamte Kontrolle über den Ausdruck einschließen, einschließlich der Erweiterung von untergeordneten Elementen, oder er kann den Standardausdruck aus der Ausdrucks Auswertung abrufen, ihn leicht ändern, aber andere Vorgänge, wie z. b. die Erweiterung zurück zum EE, verschieben.
Implementierungen dieser Schnittstelle können einschränken, wenn Sie mithilfe eines Filters aufgerufen werden, der in ihrer Komponenten Konfiguration definiert ist. Die folgenden Eigenschaften können verwendet werden: EngineID, runtimeId, SourceID, symbolproviderid, visualizerid.
public interface class IDkmCustomVisualizer
public interface class IDkmCustomVisualizer
__interface IDkmCustomVisualizer
public interface IDkmCustomVisualizer
type IDkmCustomVisualizer = interface
Public Interface IDkmCustomVisualizer
Methoden
| EvaluateVisualizedExpression(DkmVisualizedExpression, DkmEvaluationResult) |
Wertet einen visualisierten Ausdruck aus, der ein dkmevaluationresult zurückgibt. |
| GetChildren(DkmVisualizedExpression, Int32, DkmInspectionContext, DkmChildVisualizedExpression[], DkmEvaluationResultEnumContext) |
Ruft einen enumerationskontext ab, der zum Abrufen der untergeordneten Elemente dieses Auswertungs Ergebnisses verwendet wird. Diese wird in allen Ausdrucks Bewertungs Fenstern verwendet. |
| GetItems(DkmVisualizedExpression, DkmEvaluationResultEnumContext, Int32, Int32, DkmChildVisualizedExpression[]) |
Wird aufgerufen, um Elemente aus einer Instanz von dkmevaluationresultenumschlag abzurufen, die durch einen früheren Aufruf von GetChildren erstellt wurde. |
| GetUnderlyingString(DkmVisualizedExpression) |
Diese Methode wird für Auswertungs Ergebnisse verwendet, die dkmevaluationresultflags. rawstring enthalten, um die zugrunde liegende Zeichenfolge ohne einschließende Anführungszeichen oder Escapesequenzen abzurufen. Diese Methode wird aufgerufen, um eine der verschiedenen Zeichen folgen schnell Ansichten in einem Ausdrucks auswertungsfenster anzuzeigen (Klicken Sie auf das Lupensymbol). |
| SetValueAsString(DkmVisualizedExpression, String, Int32, String) |
Ändert den Wert des angegebenen Auswertungs Ergebnisses (nicht schreibgeschützt), damit es mit der angegebenen Zeichenfolge identisch ist. Diese wird verwendet, nachdem der Benutzer einen Wert in einem der Bewertungsfenster bearbeitet hat. |
| UseDefaultEvaluationBehavior(DkmVisualizedExpression, Boolean, DkmEvaluationResult) |
Wird von der Ausdrucks Auswertung aufgerufen, wenn die untergeordneten Elemente eines visualisierten Ausdrucks erweitert werden, der Wert festgelegt wird oder die zugrunde liegende Zeichenfolge abgerufen wird. Wenn das schnell Ansichts-Add-in eine umfassende Kontrolle über den Ausdruck hat, sollte false zurückgegeben werden. Anschließend werden Aufrufe von GetChildren, GetItems, setvalueasstring und getunderlyingstring empfangen. Wenn die Schnellansicht-Add-in diese Vorgänge vollständig auf die Ausdrucks Auswertung zurückschieben möchte, sollte Sie "true" zurückgeben. Außerdem muss die Ausdrucks Auswertung die Instanz von dkmevaluationresult, die von der EE stammen, über eine der idkmcustomvisualizercallback-Methoden zurücklassen. Beachten Sie, dass das Add-in das standardmäßige dkmevaluationresult von der EE abgerufen haben muss, wenn der EE das Objekt Steuern soll. Die Rückgabe von true von dieser Methode wird hauptsächlich von schnell Ansichts-AddIns verwendet, die nur etwas kleiner wie die Ansicht eines Werts optimieren, aber keine Erweiterungs-oder Einstellungs Werte ändern möchten. |