Udostępnij za pośrednictwem

Metoda Commands.AddCommandBar —

  • Artykuł

Tworzy pasek poleceń, który jest zapisane i będą dostępne przy następnym uruchomieniu środowiska naturalnego.

Przestrzeń nazw:  EnvDTE
Zestaw:  EnvDTE (w EnvDTE.dll)

Składnia

'Deklaracja
Function AddCommandBar ( _
    Name As String, _
    Type As vsCommandBarType, _
    CommandBarParent As Object, _
    Position As Integer _
) As Object

Object AddCommandBar(
    string Name,
    vsCommandBarType Type,
    Object CommandBarParent,
    int Position
)

Object^ AddCommandBar(
    [InAttribute] String^ Name, 
    [InAttribute] vsCommandBarType Type, 
    [InAttribute] Object^ CommandBarParent, 
    [InAttribute] int Position
)

abstract AddCommandBar : 
        Name:string * 
        Type:vsCommandBarType * 
        CommandBarParent:Object * 
        Position:int -> Object

function AddCommandBar(
    Name : String, 
    Type : vsCommandBarType, 
    CommandBarParent : Object, 
    Position : int
) : Object

Parametry

  • Name
    Typ: String

    Wymagany.Nazwa dla nowego paska poleceń.

  • CommandBarParent
    Typ: Object

    Opcjonalne.Biuro CommandBar obiektu, do którego ma zostać dodany nowy pasek poleceń. (Jest to wymagane, jednak jeśli Type jest vsCommandBarTypeMenu.)

  • Position
    Typ: Int32

    Opcjonalne.Pozycja indeksu, zaczynając od jednego, na pasku poleceń, aby umieścić nowy pasek poleceń.

Wartość zwracana

Typ: Object
Obiekt CommandBar.

Uwagi

CommandBar Obiektu jest członkiem modelu obiektów programu Microsoft Office.

Pasek poleceń dodane przy użyciu tej metody jest pasek stałe poleceń, która jest dostępna w każdej sesji IDE, czy dodatek jest załadowany.Tej metody należy używać aby dodać pasek polecenia tylko wtedy, gdy chcesz pasek poleceń stałe.Tę metodę należy wywołać tylko raz, gdy dodatek jest ładowany po raz pierwszy.Jeśli pasek tymczasowe polecenie, który pojawia się tylko gdy dodatek jest faktycznie załadowany, należy użyć DTE.CommandBars.Add w czasie gdy załadować dodatek, a następnie wywołać DTE.CommandBars.Remove metoda po rozładowaniu dodatek.

Ponieważ pasek poleceń stałe pojawia się nawet kiedy dodatek nie jest załadowany, należy koniecznie usunąć go, gdy dodatek jest odinstalowywany.W związku z tym należy użyć plik MSI do instalowania i odinstalowywania dodatku i dodać akcję niestandardową do odinstalowania programu.

Aby uzyskać więcej informacji na temat dodawania i usuwania pasków poleceń stałych i tymczasowych, zobacz PORADNIKI: dodawanie przycisków, commandbars i paski narzędzi do programu Visual Studio .NET z dodatku i PORADNIKI: usuwanie poleceń i elementów interfejsu użytkownika podczas odinstalowywania dodatku programu Visual Studio .NET.

Przykłady

' Macro code.
Imports Microsoft.VisualStudio.CommandBars
Sub AddCommandBarExample()
   ' Before running, you must add a reference to the Office 
   ' typelib to gain access to the CommandBar object. 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 = cmds.AddNamedCommand(colAddins.Item(1), "mycommand", _
   "mycommand", "tooltip for mycommand", True)
End Sub

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

Commands Interfejs

Przestrzeń nazw EnvDTE