Compartilhar via

Método IOleInPlaceComponentUIManager.OnUIComponentEnterState (UInt32, UInt32, UInt32)

  • Artigo

 

Publicado: abril de 2016

Informa o ambiente para que um objeto de VSPackage in loco inseriu um novo estado.

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

Sintaxe

void OnUIComponentEnterState(
    uint dwCompRole,
    uint dwStateId,
    uint dwReserved
)

void OnUIComponentEnterState(
    unsigned int dwCompRole,
    unsigned int dwStateId,
    unsigned int dwReserved
)

abstract OnUIComponentEnterState : 
        dwCompRole:uint32 *
        dwStateId:uint32 *
        dwReserved:uint32 -> unit

Sub OnUIComponentEnterState (
    dwCompRole As UInteger,
    dwStateId As UInteger,
    dwReserved As UInteger
)

Parâmetros

  • dwCompRole
    [in] Função do objeto no local que tiver inserido o novo estado.Para obter uma lista válida dwCompRole valores, consulte OLEROLE.
  • dwStateId
    [in] Identificador que representa o novo estado.Para obter uma lista válida dwStateId valores, consulte _OLECSTATE.
  • dwReserved
    [in] Reservado para uso futuro.Deve ser definido como 0.

Comentários

Quando um objeto de VSPackage no local gerenciado pela SOleComponentUIManager serviço entra um novo estado, ele chama OnUIComponentEnterState.Um dos Estados importantes é o estado restrito, significando que uma caixa de diálogo modal está visível.O SOleComponentUIManager informa todos os objetos no local que são afetados pelas alterações de interface de usuário e o objeto ativo da interface do usuário mais interno.

Qualquer objeto no local assumir o papel principal componente subcomponentes é responsável por notificar a esses objetos subcomponente do novo estado.Os objetos do subcomponente por sua vez devem executar o processamento necessário baseado no estado que está sendo inserido.Para obter uma lista de estados válidos, consulte _OLECSTATE.

O OnUIComponentEnterState método é parecido com o OnComponentEnterState método, que informa o SOleComponentManager serviço sobre alterações nos Estados que não afetam a interface do usuário.

O SOleComponentUIManager usa o dwCompRole parâmetro para determinar quais objetos no local devem ser notificado sobre a alteração de estado.Se o chamador é um componente principal, em seguida, normalmente apenas o mais interno da interface do usuário ativo objeto requer notificação.O componente principal deverá notificar seus subcomponentes chamando OnEnterState.

Se o chamador for um controle de componente, ele deve ser a interface do usuário ativa.

Se um subcomponente é o chamador desse método, o SOleComponentUIManager notifica o componente principal e o componente ativo da interface do usuário.O subcomponente deve estar preparado para receber o reentrantes OnEnterState chamada que vem antes do OnUIComponentEnterState retorna.

Consulte também

Interface IOleInPlaceComponentUIManager
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo