Enumeração OLEROLE

 

Especifica a maneira em que um componente está sendo usado em relação ao seu host.

Namespace:   Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

public enum OLEROLE

public enum class OLEROLE

type OLEROLE

Public Enumeration OLEROLE

Membros

	Nome do membro	Descrição
	OLEROLE_COMPONENTCONTROL	Indica que o componente não contém objetos aninhados de local e não está incluído na cadeia de roteamento de comando do recipiente.Portanto, os controles de componente podem manipular apenas comandos quando elas estiverem no estado ativo da interface do usuário.OLEROLE_COMPONENTCONTROLé a função padrão para um componente; todos os componentes devem presumir que eles estão sendo usados como controles de componente salvo indicação em contrário.Controles de componente não implementam IOleInPlaceComponent.Eles devem retornar o IOleComponentUIManager o ponteiro de interface chamando seus sites IServiceProvider interface.
	OLEROLE_COMPONENTHOST	Indica que o componente é o quadro mais externo; ele é usado no nível do ambiente.
	OLEROLE_HOSTEXTENSION	Indica que o componente está sendo usado no mesmo nível como o ambiente.
	OLEROLE_MAINCOMPONENT	Indica que o componente tem conhecimento de tempo de compilação de um objeto aninhado que ele hospedará no lugar.Um componente principal tem seus elementos de interface de usuário criados para o ambiente e controla os comandos de menu disponíveis para ele e para todos os seus subcomponentes aninhados.Isso também é conhecido como um componente conectada.
	OLEROLE_SUBCOMPONENT	Indica que o componente tem conhecimento de tempo de compilação de um objeto aninhado que ela contém no lugar como um componente principal, mas ele não é, essencialmente, no controle dos seus modos de interface do usuário.No entanto, um subcomponente está incluído na cadeia de roteamento de comando do recipiente e, assim, pode manipular a comandos quando um objeto aninhado se torna visível e leva o foco.
	OLEROLE_TOPLEVELCOMPONENT	Indica que o componente é um componente de sem janela restrita flutuante independente sem capacidades in loco.Componentes de nível superior precisam coordenar a modalidade e serviços de loop de mensagem com o ambiente por meio do SOleComponentManager service.
	OLEROLE_UNKNOWN	Função é indefinida.

Comentários

A função de um componente é importante de várias maneiras.Alguns componentes só funcionará corretamente se forem usados na função de um componente principal.Esses componentes falha na chamada IOleInPlaceComponent::UseComponentUIManager.Outros componentes exibem um menu de contexto diferente dependendo da função que eles estão fazendo.Por exemplo, no modo de design do Microsoft Access, no menu do botão direito do mouse para um controle em um subformulários é diferente para um controle em um formulário principal.

Quando um componente recebe o foco por chamada IOleComponentUIManager::UIActivateForMe, ele passa a sua função como um parâmetro na chamada.Essas informações de função são usadas pelo ambiente quando o seu componente principal é o componente ativo da interface do usuário.O componente pode passar um conjunto de sinalizadores de volta para o ambiente que controla os aspectos do componente no ambiente.

COM assinatura

A partir de oleipc.idl.

[C++]

Consulte também

Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo