Share via

IDebugCustomViewer::DisplayValue

  • Artigo

Esse método é chamado para exibir o valor especificado.

Sintaxe

int DisplayValue(
   IntPtr          hwnd,
   uint            dwID,
   object          pHostServices,
   IDebugProperty3 pDebugProperty
);

Parâmetros

hwnd
[em] Janela pai

dwID
[em] ID para visualizadores personalizados que oferecem suporte a mais de um tipo.

pHostServices
[in] Reservado. Sempre definido como null.

pDebugProperty
[em] Interface que pode ser usada para recuperar o valor a ser exibido.

Valor de retorno

Se for bem-sucedido, retorna S_OKo código de erro.

Comentários

A exibição é "modal" em que esse método criará a janela necessária, exibirá o valor, aguardará a entrada e fechará a janela, tudo antes de retornar ao chamador. Isso significa que o método deve lidar com todos os aspectos da exibição do valor da propriedade, desde a criação de uma janela para saída, até a espera pela entrada do usuário e a destruição da janela.

Para oferecer suporte à alteração do valor no objeto IDebugProperty3 fornecido, você pode usar o método SetValueAsStringWithError — se o valor puder ser expresso como uma cadeia de caracteres. Caso contrário, é necessário criar uma interface personalizada — exclusiva para o avaliador de expressão que implementa esse método — no mesmo objeto que implementa DisplayValue a IDebugProperty3 interface. Essa interface personalizada forneceria métodos para alterar os dados de um tamanho ou complexidade arbitrária.

Confira também