IOleItemContainer

9/8/2008

Essa interface é usado pelo item monikers quando forem ligado aos objetos que eles identificam.

Quando qualquer contêiner de Objetos usa monikers item para identificar seus objetos, ele deve definir uma esquema de nomeação para esses objetos.

Do contêiner IOleItemContainer implementação usa conhecimento desse esquema de nomeação para recuperar um objeto fornecido um nome específico.

Item monikers usam do o contêiner IOleItemContainer implementação durante ligação.

Quando a implementar

Você deve implementar IOleItemContainer Se você for um provedor moniker entregando fora monikers item. Sendo um provedor moniker significa entregando sem identificadores de origem que identifiquem os objetos para torná-los acessível aos clientes moniker.

Você deve usar monikers item se os objetos que é identificando estão contidos em outro objeto e podem ser identificados individualmente usando um seqüência de caracteres.

The most comum exemplo dos provedores moniker são aplicativos OLE que suporte vinculação. Se seu aplicativo OLE suporta vinculando a objetos menor do que um documento File-based, você precisará usar monikers item.

Para um aplicativo servidor que permite vinculação a uma parte de um documento (such as seleções em um documento), use os monikers item para identificar esses objetos.

Para um aplicativo contêiner que permite vinculação a incorporado objetos, você usa os monikers item para identificar o incorporado objetos.

Você deve definir uma esquema de nomeação para identificar os objetos dentro de contêiner; de exemplo, incorporado objetos em um documento pode ser identificado com nomes da forma embedobj1, embedobj2 e assim por diante, enquanto intervalos de células em uma planilha eletrônica podem ser identificados com nomes da forma A1:E7, G5:M9 e assim por diante.

(Intervalos de células em uma planilha eletrônica são exemplos de pseudo-Objects porque eles não têm suas próprias armazenamento persistente, mas simplesmente representam uma parte de estado interno do contêiner.)

Você cria um moniker item que representa do um objeto nome usando o CreateItemMoniker função e entregá-out para um cliente moniker. Quando um moniker item estiver ligado, a implementação de IOleItemContainer deve poder tomar um nome e recuperar o correspondente objeto.

Quando usar

Os aplicativos geralmente não chamar IOleItemContainer Métodos diretamente. A implementação moniker item das IMoniker interface é o primário chamador do IOleItemContainer Métodos.

Métodos

A seguinte tabela mostra os métodos para esta interface na ordem que o compilador chama os métodos. Como todas as interfaces COM, essa interface herda os métodos para a IUnknown interface.

Método IUnknown	Descrição
Falha de QueryInterface	Retorna os ponteiros para com suporte interfaces.
AddRef	Contagem de referência incrementos.
Lançamento	Contagem de referência diminui.

Método IParseDisplayName	Descrição
ParseDisplayName	Analisa exibir nome do objeto para moniker forma.

Método IOleContainer	Descrição
EnumObjects	Enumera objetos em um contêiner.
LockContainer	Mantém contêiner execução até explicitamente lançado.

Método IOleItemContainer	Descrição
GetObject	Retorna um ponteiro para um objeto especificado.
GetObjectStorage	Retorna um ponteiro para armazenamento de um objeto.
IsRunning	Verifica se um objeto é execução.

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

CreateItemMoniker
IParseDisplayName
IParseDisplayName::ParseDisplayName