Commands.AddCommandBar – metoda

Článek
10/27/2012

Vytvoří panel příkazů, která je uložena a budou k dispozici při příštím spuštění prostředí.

Obor názvů: EnvDTE
Sestavení: EnvDTE (v EnvDTE.dll)

Syntaxe

'Deklarace
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: System.String
Povinné.Název pro nový panel příkazů.

Type
Typ: EnvDTE.vsCommandBarType
Povinné.A vsCommandBarType konstanta, která určuje typ panelu příkazů:

CommandBarParent
Typ: System.Object
Nepovinné.Kancelář CommandBar objektu, na který má být přidán nový panel příkazů.(To je nutné, avšak pokud Type je vsCommandBarTypeMenu.)

Position
Typ: System.Int32
Nepovinné.Pozice indexu od jednoho panelu příkaz umístit nový panel příkazů.

Vrácená hodnota

Typ: System.Object
Objekt CommandBar.

Poznámky

CommandBar Objektu je členem objektového modelu aplikace Microsoft Office.

Panel příkazů přidána pomocí této metody je trvalý příkaz panel, který je k dispozici v každé relaci IDE, zda-li doplněk načten.Tuto metodu používejte pouze pokud chcete panel trvalý příkaz přidat panel příkazů.Tato metoda by měla volat pouze jednou při doplněk načten první.Pokud chcete, aby panelu dočasné příkazů, které se zobrazí, pouze pokud doplněk je skutečně načtený, musíte použít DTE.CommandBars.Add metoda při načtení doplňku a potom volat DTE.CommandBars.Remove metoda po odinstalování doplňku.

Protože trvalý příkaz panel zobrazí i při doplněk není načten, by nezapomeňte ji odebrat, je-li doplněk odinstalován.Proto musí použít k instalaci a odinstalování doplňku MSI a přidat vlastní akci odinstalační program.

Další informace o přidávání a odebírání panely příkazů trvalé a dočasné, viz postupy: Přidání tlačítka, commandbars a panely nástrojů Visual Studio.NET z v a postupy: odebrání příkazů a prvky uživatelského rozhraní během Visual Studio.ČISTÉ odinstalování doplňku.

Příklady

' 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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

Commands Rozhraní

EnvDTE – obor názvů

Sdílet prostřednictvím