每当客户端希望将对象转换为要显示的字符串时,将调用 ToDisplayString 方法(在 UI 中等控制台)。不应将此类字符串转换用于其他编程作的基础。 字符串转换本身可能会受到传递给调用的元数据的影响。 字符串转换应每次尝试都遵循 PreferredRadix 和 PreferredFormat 键。
语法
HRESULT ToDisplayString(
IModelObject *contextObject,
IKeyStore *metadata,
BSTR *displayString
);
参数
contextObject
将转换为显示字符串的实例(此指针)在此参数中传递。
metadata
一个可选元数据存储,用于定义调用方希望字符串转换的方式。 实现应每次尝试都遵循存储中的请求(特别是 PreferredRadix 和 PreferredFormat 密钥)。
displayString
此处将返回由 SysAllocString 函数分配的字符串转换。
返回值
此方法返回 HRESULT,指示成功或失败。
要求
要求 | 价值 |
---|---|
标头 | dbgmodel.h |