Metodo Commands.AddCommandBar
Crea una barra di comando che viene salvata e disponibile la volta successiva che l'ambiente viene avviato.
Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
Sintassi
'Dichiarazione
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
Parametri
- Name
Tipo: System.String
obbligatorio.Un nome per la nuova barra dei comandi.
- Type
Tipo: EnvDTE.vsCommandBarType
obbligatorio.In vsCommandBarType costante che determina il tipo di barra dei comandi:
- CommandBarParent
Tipo: System.Object
facoltativo.Office CommandBar oggetto a cui la nuova barra dei comandi necessario aggiungere.(Questo è obbligatorio, tuttavia, si Type viene vsCommandBarTypeMenu).
- Position
Tipo: System.Int32
facoltativo.La posizione di indice, a partire da una, nella barra dei comandi per inserire la nuova barra dei comandi.
Valore restituito
Tipo: System.Object
In CommandBar oggetto.
Note
CommandBar l'oggetto è un membro del modello a oggetti di Microsoft Office.
La barra dei comandi aggiunta mediante questo metodo è una barra dei comandi permanente, disponibile in ogni passaggio dell'IDE o meno il componente aggiuntivo viene caricato.È consigliabile utilizzare questo metodo per aggiungere una barra dei comandi solo se si desidera una barra dei comandi permanente.È necessario chiamare solo quando questo metodo, quando il componente aggiuntivo viene caricato per la prima volta.Se si desidera una barra dei comandi temporanea, che viene visualizzato solo quando il componente aggiuntivo viene effettivamente caricato, è necessario utilizzare DTE.CommandBars.Add il metodo durante il caricamento del componente aggiuntivo e quindi chiama DTE.CommandBars.Remove metodo quando si scarica il componente aggiuntivo.
Poiché una barra dei comandi permanente viene visualizzato anche quando il componente aggiuntivo non viene caricato, è necessario assicurarsi di rimuoverlo quando il componente aggiuntivo viene disinstallato.Pertanto, è necessario utilizzare un file MSI per installare e disinstallare il componente aggiuntivo e aggiungere un'azione personalizzata al programma di disinstallazione.
Per ulteriori informazioni sull'aggiunta e sulla rimozione barre dei comandi permanenti e temporanei, vedere HOWTO: Pulsanti, commandbars e barre degli strumenti di aggiunta a Visual Studio .NET. da un componente aggiuntivo e .
Esempi
' 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
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.