Commands2.AddNamedCommand-Methode (AddIn, String, String, String, Boolean, Int32, array<Object %, Int32)

  • Artikel

Erstellt einen benannten Befehl, der von der Umgebung gespeichert wird und beim nächsten Start der Umgebung zur Verfügung steht, auch wenn das Add-In beim Umgebungsstart nicht geladen wird.

Namespace:  EnvDTE80
Assembly:  EnvDTE80 (in EnvDTE80.dll)

Syntax

'Declaration
Function AddNamedCommand ( _
    AddInInstance As AddIn, _
    Name As String, _
    ButtonText As String, _
    Tooltip As String, _
    MSOButton As Boolean, _
    Bitmap As Integer, _
    ByRef ContextUIGUIDs As Object(), _
    vsCommandDisabledFlagsValue As Integer _
) As Command

Command AddNamedCommand(
    AddIn AddInInstance,
    string Name,
    string ButtonText,
    string Tooltip,
    bool MSOButton,
    int Bitmap,
    ref Object[] ContextUIGUIDs,
    int vsCommandDisabledFlagsValue
)

Command^ AddNamedCommand(
    [InAttribute] AddIn^ AddInInstance, 
    [InAttribute] String^ Name, 
    [InAttribute] String^ ButtonText, 
    [InAttribute] String^ Tooltip, 
    [InAttribute] bool MSOButton, 
    [InAttribute] int Bitmap, 
    [InAttribute] array<Object^>^% ContextUIGUIDs, 
    [InAttribute] int vsCommandDisabledFlagsValue
)

abstract AddNamedCommand : 
        AddInInstance:AddIn * 
        Name:string * 
        ButtonText:string * 
        Tooltip:string * 
        MSOButton:bool * 
        Bitmap:int * 
        ContextUIGUIDs:Object[] byref * 
        vsCommandDisabledFlagsValue:int -> Command 

function AddNamedCommand(
    AddInInstance : AddIn, 
    Name : String, 
    ButtonText : String, 
    Tooltip : String, 
    MSOButton : boolean, 
    Bitmap : int, 
    ContextUIGUIDs : Object[], 
    vsCommandDisabledFlagsValue : int
) : Command

Parameter

  • AddInInstance
    Typ: EnvDTE.AddIn
    Erforderlich.Das AddIn-Objekt fügt den neuen Befehl hinzu.
  • Name
    Typ: System.String
    Erforderlich.Die Kurzform des Namens für den neuen Befehl.AddNamedCommand verwendet das Präfix "Addins.Progid.", um einen eindeutigen Namen zu erstellen.
  • ButtonText
    Typ: System.String
    Erforderlich.Der zu verwendende Name, wenn der Befehl an eine Schaltfläche gebunden ist, die anstelle des Symbols mit ihrem Namen angezeigt wird.
  • Tooltip
    Typ: System.String
    Erforderlich.Der angezeigte Text, wenn ein Benutzer mit dem Mauszeiger auf eines der an den neuen Befehl gebundenen Steuerelemente zeigt.
  • MSOButton
    Typ: System.Boolean
    Erforderlich.Zeigt an, ob das Schaltflächenbild für den benannten Befehl ein Office-Bild ist.True = Schaltfläche.Wenn MSOButton False ist, dann ist Bitmap die ID einer 16x16-Bitmapressource (jedoch keine Symbolressource) in einer Ressourcen-DLL von Visual C++, die sich in einem Ordner mit dem Gebietsschemabezeichner der Sprache (1033 für Englisch) befinden muss. Weitere Informationen zum Abrufen der Bitmap-ID-Werte von MSO-Schaltflächen finden Sie unter "Auflisten der Oberflächen von Schaltflächen in der Befehlszeile für das Microsoft Office-System".
  • Bitmap
    Typ: System.Int32
    Optional.Die ID einer auf der Schaltfläche anzuzeigenden Bitmap.
  • ContextUIGUIDs
    Typ: array<System.Object[]%
    Optional.Ein SafeArray von GUIDs, das die Umgebungskontexte (d. h. Debugmodus, Entwurfsmodus usw.) bestimmt, in denen der Befehl angezeigt wird.Siehe vsCommandDisabledFlags.

Rückgabewert

Typ: EnvDTE.Command
Ein Command-Objekt.

Implementiert

Commands.AddNamedCommand(AddIn, String, String, String, Boolean, Int32, array<Object[]%, Int32)

Hinweise

Add-Ins können später den ButtonText-Namen ändern, indem sie auf die QueryStatus-Methode reagieren. Wenn der Text mit # beginnt, besteht der Rest der Zeichenfolge aus einer ganzen Zahl, die eine Ressourcen-ID in der registrierten Satellite-DLL des Add-Ins darstellt.

Der ContextUIGUIDs-Parameter und der vsCommandStatusValue-Parameter werden verwendet, wenn das Add-In nicht geladen wird und daher nicht auf die QueryStatus-Methode reagieren kann. Wenn ContextUIGUIDs leer ist, bleibt der Befehl so lange aktiviert, bis das Add-In geladen wurde und auf QueryStatus antworten kann.

Das Add-In kann Aufrufbenachrichtigungen über die IDTCommandTarget-Schnittstelle empfangen. Mit der OnConnection-Methode der IDTExtensibility2-Schnittstelle kann eine Schaltfläche hinzugefügt werden.

Beispiele

Imports Microsoft.VisualStudio.CommandBars
Sub AddControlExample()
   ' 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 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.
   cmds.AddCommandBar("Mycmdbar", vsCommandBarType.vsCommandBarTypeToolbar)
   MsgBox("Commandbar name: " & cmdbarobj.Name)
   cmdobj.AddControl(cmdbarobj)
   cmds.AddNamedCommand(colAddins.Item(1), "MyCommand", "Button Text", "Some tooltip", True)
End Sub

.NET Framework-Sicherheit

Siehe auch

Referenz

Commands2 Schnittstelle

AddNamedCommand-Überladung

EnvDTE80-Namespace