Método IStringDisplayableConcept::ToDisplayString (dbgmodel.h)

O método ToDisplayString é chamado sempre que um cliente deseja converter um objeto em uma cadeia de caracteres a ser exibida (para console, na interface do usuário etc...). Essa conversão de cadeia de caracteres não deve ser usada com base em manipulação programática adicional. A conversão de cadeia de caracteres em si pode ser profundamente influenciada pelos metadados passados para a chamada. Uma conversão de cadeia de caracteres deve fazer todas as tentativas de honrar as chaves PreferredRadix e PreferredFormat.

Sintaxe

HRESULT ToDisplayString(
  IModelObject *contextObject,
  IKeyStore    *metadata,
  BSTR         *displayString
);

Parâmetros

contextObject

A instância (esse ponteiro) que está sendo convertida em uma cadeia de caracteres de exibição é passada nesse argumento.

metadata

Um repositório de metadados opcional que define como o chamador gostaria que a cadeia de caracteres fosse convertida. A implementação deve fazer todas as tentativas de atender às solicitações no repositório (em particular, as chaves PreferredRadix e PreferredFormat).

displayString

A conversão de cadeia de caracteres conforme alocada pela função SysAllocString será retornada aqui.

Retornar valor

Esse método retorna HRESULT que indica êxito ou falha.

Requisitos

Confira também

Interface IStringDisplayableConcept