IDkmCustomVisualizer Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Essa interface é implementada por visualizadores do avaliador de expressão personalizada para personalizar a exibição de uma expressão programaticamente. Isso normalmente é feito para dar suporte a visualizações que não são possíveis usando a sintaxe do visualizador nativo ou para habilitar a visualização sem informações simbólicas completas. O Visualizador pode assumir o controle total da expressão, incluindo a expansão de filhos, ou pode obter a expressão padrão do avaliador de expressão, modificá-la ligeiramente, mas adiar outras operações, como a expansão de volta para o EE.
As implementações dessa interface podem restringir quando são chamadas usando um filtro definido em sua configuração de componente. As propriedades a seguir podem ser usadas: Engineid, runtimeId, SourceID, SymbolProviderId, Visualizeid.
public interface class IDkmCustomVisualizer
public interface class IDkmCustomVisualizer
__interface IDkmCustomVisualizer
public interface IDkmCustomVisualizer
type IDkmCustomVisualizer = interface
Public Interface IDkmCustomVisualizer
Métodos
| EvaluateVisualizedExpression(DkmVisualizedExpression, DkmEvaluationResult) |
Avaliar uma expressão visualizada retornando um DkmEvaluationResult para ela. |
| GetChildren(DkmVisualizedExpression, Int32, DkmInspectionContext, DkmChildVisualizedExpression[], DkmEvaluationResultEnumContext) |
Obtém um contexto de enumeração usado para obter os filhos desse resultado de avaliação. Isso é usado em todas as janelas de avaliação de expressão. |
| GetItems(DkmVisualizedExpression, DkmEvaluationResultEnumContext, Int32, Int32, DkmChildVisualizedExpression[]) |
Chamado para obter itens de uma instância do DkmEvaluationResultEnumContext criado por uma chamada anterior para GetChildren. |
| GetUnderlyingString(DkmVisualizedExpression) |
Esse método é usado para resultados de avaliação que incluem DkmEvaluationResultFlags. RawString para obter a cadeia de caracteres subjacente, sem aspas delimitadores ou sequências de escape. Esse método é invocado para exibir um dos vários visualizadores de cadeia de caracteres em uma janela de avaliação de expressão (clique no ícone de lupa). |
| SetValueAsString(DkmVisualizedExpression, String, Int32, String) |
Modifica o valor do resultado de avaliação fornecido (considerado como não somente leitura) para corresponder à cadeia de caracteres especificada. Isso é usado depois que o usuário edita um valor em qualquer uma das janelas de avaliação. |
| UseDefaultEvaluationBehavior(DkmVisualizedExpression, Boolean, DkmEvaluationResult) |
Chamado pelo avaliador de expressão quando os filhos de uma expressão visualizada estão sendo expandidos, o valor está sendo definido ou a cadeia de caracteres subjacente está sendo obtida. Se o suplemento do visualizador quiser o controle completo da expressão, ele deverá retornar false. Em seguida, ele receberá chamadas para GetChildren, GetItems, SetValueAsString e getsubjacentestring. Se o suplemento do visualizador quiser adiar completamente essas operações para o avaliador de expressão, ele deverá retornar true. Ele também deve dar ao avaliador de expressão de volta a instância do DkmEvaluationResult que veio do EE por meio de um dos métodos IDkmCustomVisualizerCallback. Observe que o AddIn deve ter obtido o DkmEvaluationResult padrão do EE se desejar que o EE controle o objeto. Retornar true desse método é usado principalmente pelos suplementos do visualizador que apenas ajustam algo pequeno, como a exibição de um valor, mas não desejam modificar os valores de expansão ou configuração. |