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.

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

  • Position
    Typ: System.Int32
    Opcjonalne.Pozycja indeksu począwszy od jednego paska poleceń, aby umieścić nowy pasek poleceń.

Wartość zwracana

Typ: System.Object
A CommandBar object.

Uwagi

CommandBar Obiektu jest model obiektów programu Microsoft Office.

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

Ponieważ pasek stałe polecenia pojawia się nawet gdy dodatek nie jest załadowana, należy pamiętać, aby ją usunąć, gdy dodatek jest odinstalowywany.W związku z tym należy użyć MSI do instalowania i odinstalowywania dodatku i dodać akcję niestandardową do dezinstalacji programu.

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

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