Commands.AddCommandBar – metoda

Článek
08/11/2011

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 nového panelu příkazů.

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

CommandBarParent
Typ: System.Object
Nepovinné.Úřad CommandBar objekt, 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
A CommandBar objektu.

Poznámky

CommandBar Objektu je členem modelu objektu Microsoft Office.

Panel příkazů přidána pomocí této metody je řádek trvalý příkaz, který je k dispozici v každé relaci IDE nebo načtení doplňku. Tuto metodu používejte pouze pokud chcete panel trvalý příkaz přidat panel příkazů. Tato metoda by měla zavolat pouze jednou, pokud doplněk načten první. Pokud chcete panel příkazů dočasné, která se zobrazí, pouze pokud doplněk je skutečně naloženou, musíte použít DTE.CommandBars.Add Při načtení doplňku a potom voláním metody DTE.CommandBars.Remove Metoda doplněk přidat in.

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

Zobrazit další informace o přidávání a odebírání panely příkazů trvalé a dočasné Postupy: Přidání tlačítka, commandbars a panely nástrojů Visual Studio.NET-in 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é

Odkaz

Commands Rozhraní

EnvDTE – obor názvů

Sdílet prostřednictvím