Método Command.AddControl

Artigo
08/01/2011

Cria um controle de barra de comandos persistente para o comando.

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
Function AddControl ( _
    Owner As Object, _
    Position As Integer _
) As Object

Object AddControl(
    Object Owner,
    int Position
)

Object^ AddControl(
    [InAttribute] Object^ Owner, 
    [InAttribute] int Position
)

abstract AddControl : 
        Owner:Object * 
        Position:int -> Object

function AddControl(
    Owner : Object, 
    Position : int
) : Object

Parâmetros

Owner
Tipo: System.Object
Obrigatório.A CommandBar objeto ao qual o novo controle de barra de comando está a ser adicionado.

Position
Tipo: System.Int32
Opcional.A posição de índice, começando em uma, na barra de comando para colocar o novo controle.

Valor de retorno

Tipo: System.Object
A CommandBarControl objeto.

Comentários

O ambiente salva o controle e seu posicionamento, tornando disponíveis de acordo com o comando ContextUIGUIDs ou suas respostas para QueryStatus Method durante cada nova sessão do ambiente, independentemente se o suplemento é carregado.

Exemplos

' Macro code.
Imports Microsoft.Office.Core
Sub AddControlExample()
   ' Before running, you must add a reference to
   ' Microsoft.VisualStudio.CommandBars. Also, 
   ' for this example to work correctly, there should be an add-in 
   ' available in the Visual Studio environment.
   Dim cmds As Commands
   Dim cmdobj As Command
   Dim customin, customout As Object
   Dim cmdbarobj As CommandBar
   Dim colAddins As AddIns

   ' Set references.
   colAddins = DTE.AddIns()
   cmds = DTE.Commands
   cmdobj = cmds.Item("File.NewFile")

   ' Create a toolbar and add the File.NewFile command to it.
   cmdbarobj = cmds.AddCommandBar("MyCmdBar", vsCommandBarType.vsCommandBarTypeToolbar)
   MsgBox("Commandbar name: " & cmdbarobj.Name)
   cmdobj.AddControl(cmdbarobj)
   cmds.AddNamedCommand(colAddins.Item(1), "MyCommand", "Button Text", "Some tooltip", True)
End Sub

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Command Interface

Namespace EnvDTE

Partilhar via