Commands.AddNamedCommand أسلوب

إنشاء أمر مسماة هو المحفوظة بالبيئة وتوفير التالي وقت بدء تشغيل بيئة، حتى لو الوظيفة الإضافية هو لم يتم تم تحميلهها عند بدء التشغيل في بيئة.

مساحة الاسم:  EnvDTE
التجميع:  EnvDTE (في EnvDTE.dll)

بناء الجملة

'إقرار
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

المعلمات

• AddInInstance
  النوع: EnvDTE.AddIn
  مطلوبة.AddInهو إضافة كائن جديد الأمر.

• Name
  النوع: System.String
  مطلوبة.نموذج قصير من اسم للأمر الجديد الخاص بك.AddNamedCommandيستخدم في المقدمةAddins.Progid.إلى بإنشاء اسم فريد.

• ButtonText
  النوع: System.String
  مطلوبة.اسم الذي سيتم استخدامه إذا كان الأمر يرتبط زر المعروضة حسب الاسم بدلاً من رمز.

• Tooltip
  النوع: System.String
  مطلوبة.نص الذي يتم عرضه عند وضع مستخدم مؤشر ماوس فوق أي عنصر تحكم منضم إلى الجديدة الأمر.

• MSOButton
  النوع: System.Boolean
  مطلوبة.الإشارة إلى ما إذا كانت صورة زر أمر المسمى هو صورة المكتب.True= زر.إذا MSOButtonكان False، ثم Bitmapهو المعرف مورد صورة نقطية 16 × 16 (ولكن ليس لمورد رمز) في Visual C + + مورد DLL التي يجب أن تكون موجودة في مجلد مع المعرف إعدادات محلية لللغة (1033 للغة الإنجليزية).

• Bitmap
  النوع: System.Int32
  اختياري.المعرف الصورة النقطية إلى عرض على butإلىn.

• ContextUIGUIDs
  النوع: array<System.Object[]%
  اختياري.SafeArray من GUID الذي يحدد أي سياقات بيئة (التي هو وتصحيح الوضع، وضع التصميم، وهكذا) إظهار الأمر.SeevsCommandDisabledFlags..

• vsCommandDisabledFlagsValue
  النوع: System.Int32

القيمة المُرجعة

النوع: EnvDTE.Command
كائن Command .

ملاحظات

الوظائف الإضافية يمكن فيما بعد بتغيير ButtonTextالاسم عن طريق الاستجابة إلى QueryStatusالأسلوب. إذا كان نص الذي يبدأ بـ "#"، تبقى السلسلة هو عدد صحيح يمثل المعرف مورد في المسجل القمر الوظيفة الإضافية لمكتبة الارتباط الحيوي.

ContextUIGUIDsمعلمة و vsCommandStatusValueمعلمة يتم استخدامها عند addin هو لا تم تحميله والاستجابة وبالتالي لا يمكن QueryStatusالأسلوب. إذا ContextUIGUIDsكانت فارغ، ثم يتم ممكّن الأمر حتى يتم تم تحميله addin ويمكن الرد على QueryStatus.

إضافة-في يمكنك تلقي إعلام في vocation من خلال IDTCommandTargetفي terface. يمكن تمت الإضافة زر باستخدام OnConnectionأسلوب من IDTExtensibility2الواجهة

أمثلة

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

• الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.

راجع أيضًَا

المرجع

Commands واجهة

Commands الأعضاء

EnvDTE مساحة الاسم