IParseDisplayName
9/8/2008
Essa interface analisa um seqüência de caracteres nome exibível para convertê-lo em um moniker para personalizado moniker implementações. Exibir nome análise é necessária quando o usuário fornece uma seqüência de caracteres para identificar um componente, as in o seguinte situações:
- Um aplicativo documento composto que ofereça suporte a vinculado componentes geralmente oferece suporte a Edit:Links caixa diálogo. Por essa caixa diálogo, o usuário pode digitar um nome exibir para especificar uma nova origem link para um componente vinculado especificado. O documento composto precisa ter esta entrada seqüência de caracteres convertido em um moniker.
- Uma linguagem script such as a linguagem macro de uma planilha eletrônica pode permitir que textual referências a um componente. Intérprete de linguagem precisa ter tal uma referência convertida em um moniker em ordem para executar a macro.
Quando a implementar
Composto documento aplicativos que vincula suporte à incorporado componentes ou para pseudo-Objects dentro de seus documentos deve fornecer uma implementação das IOleItemContainer interface, que é derivado de indiretamente IParseDisplayName.
No efeito, tal um documento composto está fornecendo um espaço para nome para identificar seus componentes internos; e seu IOleItemContainer implementação (que inclui o IParseDisplayName implementação) é a interface através de que outro aplicativo pode acessar este espaço para nome.
Como alternativa, o aplicativo documento composto pode implementar IParseDisplayName Como parte de seu objeto classe, que é acessível através de CoGetClassObject função.
Identificadores de origem que suporte seu próprio espaço para nome com personalizado requisitos para análise nomes também implementar essa interface.
Quando usar
Se você estiver implementando sua classe moniker, talvez seja necessário usar essa interface de sua implementação de IMoniker::ParseDisplayName.
Se você chamar o MkParseDisplayName função, você está usando indiretamente IParseDisplayName. Essas duas funções chamar IParseDisplayName Para analisar exibir nomes de objetos que fornecem personalizado moniker implementações.
Métodos na ordem TabelaV
Método IUnknown | Descrição |
---|---|
Retorna os ponteiros para com suporte interfaces. |
|
Incrementa a contagem de referência. |
|
Diminui o contagem de referência. |
Método | Descrição |
---|---|
Analisa o nome exibir retornando um moniker correspondente a ele. |
Remarks
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requisitos
Header | Oleidl.h, oleidl.idl |
Library | ole32.lib, uuid.lib |
Windows Embedded CE | Windows CE 3.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IMoniker::ParseDisplayName
IOleItemContainer
MkParseDisplayName