Aracılığıyla paylaş

Commands.AddNamedCommand Yöntem

  • Makale

Ortamı tarafından kaydedilir ve ortamı başlangıçta eklentisi yüklenmemiş bile, ortamın bir sonraki başlatılışında kullanımına adlandýrýlmýþ bir komut oluşturur.

Ad alanı:  EnvDTE
Derleme:  EnvDTE (EnvDTE.dll içinde)

Sözdizimi

'Bildirim
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

Parametreler

  • Name
    Tür: System.String
    Gerekli.Yeni komutu adının kısa formu.AddNamedCommandpreface kullanan Addins.Progid. benzersiz bir ad oluşturmak için.
  • ButtonText
    Tür: System.String
    Gerekli.Komut simgesinin yerine adı tarafından görüntülenen düğmeye bağlı ad.
  • Tooltip
    Tür: System.String
    Gerekli.Kullanıcı fare yeni komuta bağlı herhangi bir denetim gezdirildiğinde görüntülenen metin.
  • MSOButton
    Tür: System.Boolean
    Gerekli.Adlandırılmış komut düğmesine resim Office resmi olup olmadığını gösterir.Truedüğme =.MSOButton Olan False, sonra Bitmap 16 x 16 bit eşlem kaynak (ancak bir simge kaynaðýnýn) Visual c++ kaynak dil yerel ayar tanıtıcısını (İngilizce için 1033) olan bir klasörde bulunan dll kimliğidir.
  • Bitmap
    Tür: System.Int32
    İsteğe Bağlı.Düğmede görüntülenecek bit eşlem kimliği.
  • ContextUIGUIDs
    Tür: array<System.Object[]%
    İsteğe Bağlı.Bir SafeArray, (diğer bir deyişle, hata ayıklama modu, Tasarım modunda vb.) hangi ortam içeriklerini Göster komutu belirleyen GUID.See vsCommandDisabledFlags..

Dönüş Değeri

Tür: EnvDTE.Command
Command nesnesi

Notlar

Eklentiler daha sonra değiştirebilir ButtonText yanıt olarak adı QueryStatus yöntemi. Metin "#" ile başlıyorsa, sonra dize geri kalanı eklentinin kayıtlı uydu dll kaynak kimliği gösteren bir tamsayıdır.

ContextUIGUIDs Parametresi ve vsCommandStatusValue eklentisi yüklü değil ve bu nedenle yanıtlayamıyor parametresi kullanılır QueryStatus yöntemi. ContextUIGUIDs Eklentisi yüklü olduğu ve isteklerine yanıt verebildiğinden kadar komutu etkin sonra boş olduğundan QueryStatus.

Aracılığıyla çağırma bildirimi alabilir Add-in IDTCommandTarget arabirimi. Bir düğme kullanılarak eklenebilir OnConnection yöntemi, IDTExtensibility2 arabirimi

Örnekler

' Macro code.
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 Güvenliği

Ayrıca bkz.

Başvuru

Commands Arabirim

EnvDTE Ad Alanı