Método IVsUserContext.AddSubcontext (IVsUserContext, Int32, UInt32)

Artigo
06/13/2016

Links uma sacola subcontexto para um conjunto de propriedades de contexto do pai.

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

Sintaxe

int AddSubcontext(
    IVsUserContext pSubCtx,
    int lPriority,
    out uint pdwCookie
)

int AddSubcontext(
    IVsUserContext^ pSubCtx,
    int lPriority,
    [OutAttribute] unsigned int% pdwCookie
)

abstract AddSubcontext : 
        pSubCtx:IVsUserContext *
        lPriority:int *
        pdwCookie:uint32 byref -> int

Function AddSubcontext (
    pSubCtx As IVsUserContext,
    lPriority As Integer,
    <OutAttribute> ByRef pdwCookie As UInteger
) As Integer

Parâmetros

pSubCtx
[in] Ponteiro para o IVsUserContext interface (o conjunto de subcontexto).

lPriority
[in] Prioridade para o subcontexto.Para obter uma lista de lPriority valores, consulte VSUSERCONTEXTPRIORITY.

pdwCookie
[out, retval] Ponteiro para um identificador exclusivo para o subcontexto.

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 context.idl:

HRESULT IVsUserContext::AddSubcontext(
   [in] IVsUserContext * pSubCtx,
   [in] int lPriority,
   [out, retval] VSCOOKIE * pdwCookie
);

Um provedor de contexto pode conter um item para o qual um subcontexto específico é necessário em tempo de execução.Por exemplo, janelas de comando podem exigir tanto o contexto para o subcontexto para uma seleção dentro da janela de comando e a janela de comando.Para adicionar um subcontexto para uma seleção dentro de um provedor de contexto, você precisa primeiro criar uma sacola subcontexto para manter o subcontexto.Para obter mais informações, consulte Creating a Context or Subcontext Bag.Uma vez criada a bolsa subcontexto, chame AddAttribute para adicionar atributos, palavras-chave de pesquisa, ou F1 palavras-chave para a bolsa subcontexto.Você pode então chamar IVsUserContext.AddSubcontext para vincular a bolsa subcontexto para o conjunto de propriedades de contexto do pai.

Para bolsas de contexto, a prioridade do contexto é atribuída automaticamente pelo ambiente com base nas qual o conjunto de propriedades de contexto é enganchado até, como, por exemplo, a janela do editor, a janela de ferramenta e assim por diante.No entanto, para o subcontexto, você precisa definir a prioridade de si mesmo.No caso de uma seleção em uma janela de comando (janela de ferramenta), o novo subcontexto é fornecido um lPriority valor de VSUC_Priority_ToolWndSel.Quando os comandos alteram na janela de comando, o nome do comando é colocado no conjunto de subcontexto.

O IVsUserContext.AddSubcontext método retorna um ponteiro para um identificador exclusivo para a bolsa subcontexto em termos de conjunto de contexto.Salve esse ponteiro e usá-lo com o RemoveSubcontext método para o subcontexto de excluir.

Consulte também

Interface IVsUserContext
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via