Partilhar via


Método IOleInPlaceComponentSite.SetUIMode (UInt32)

 

Publicado: abril de 2016

Altera o modo de interface do usuário de um objeto de VSPackage no local.Este método não é suportado no momento.

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

Sintaxe

int SetUIMode(
    uint dwUIMode
)
int SetUIMode(
    unsigned int dwUIMode
)
abstract SetUIMode : 
        dwUIMode:uint32 -> int
Function SetUIMode (
    dwUIMode As UInteger
) As Integer

Parâmetros

  • dwUIMode
    [in] Identificador para o modo de interface do usuário do objeto no local.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De oleipc.idl:

HRESULT IOleInPlaceComponentSite::SetUIMode(
   [in] DWORD dwUIMode
);

Porque esse método não é suportado no momento, o ambiente lida com a alteração do modo de interface do usuário de um objeto fazendo com que o objeto recuperar o IVsWindowFrame ponteiro de seu recipiente através a SVsWindowFrame de serviço e, em seguida, chamar SetProperty e configuração o propid parâmetro para VSFPROPID_CmdUIGuid.

Quando suportado, in loco objetos devem chamar SetUIMode antes de chamar UIActivateForMe.Os objetos são capazes de fazer esta chamada pela primeira vez em sua implementação de UseComponentUIManager.

A interpretação do dwUIMode parâmetro será VSPackage específicos.Normalmente, o ambiente tem conhecimento de tempo de compilação dos modos de seus objetos no local e pode mapear os modos para conjuntos específicos de menus e barras de ferramentas.O ambiente pode organizar ter barras de ferramentas diferentes para os vários modos de interface do usuário do objeto no local.Como parte da criação e que possui as barras de ferramentas, o ambiente tem conhecimento completo dos quais comandos estão em cada barra de ferramentas e o conhecimento do qual comando grupos incluem esses comandos.O conhecimento do qual comando grupos são representados em uma determinada barra de ferramentas é necessário para gerenciar as solicitações de interface do usuário negociadas através do SOleComponentUIManager service.

Consulte também

Interface IOleInPlaceComponentSite
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo