ToolBoxItems.Add أسلوب

مقالة
09/21/2010

قم بإنشاء عنصر جديد? و يضيفه إلى من مربع الأدوات.

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

بناء الجملة

'إقرار
Function Add ( _
    Name As String, _
    Data As Object, _
    Format As vsToolBoxItemFormat _
) As ToolBoxItem

ToolBoxItem Add(
    string Name,
    Object Data,
    vsToolBoxItemFormat Format
)

ToolBoxItem^ Add(
    [InAttribute] String^ Name, 
    [InAttribute] Object^ Data, 
    [InAttribute] vsToolBoxItemFormat Format
)

abstract Add : 
        Name:string * 
        Data:Object * 
        Format:vsToolBoxItemFormat -> ToolBoxItem

function Add(
    Name : String, 
    Data : Object, 
    Format : vsToolBoxItemFormat
) : ToolBoxItem

المعلمات

Name
النوع: System.String
مطلوبة.سلسلة أحرف التسمية التوضيحية للممثل عنصر جديد?.

Data
النوع: System.Object
مطلوبة.متغير يمثل السلسلة أو عنصر تحكم أو عنصر آخر أن تمت الإضافة إلى من مربع الأدوات.

Format
النوع: EnvDTE.vsToolBoxItemFormat
اختياري.vsToolBoxItemFormatثابتة تشير إلى تنسيق العنصر الجديد.

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

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

ملاحظات

يفشل هذا الأسلوب إذا ToolBoxItemsمجموعة ينتمي إلى ToolBoxTabكائن تم حذفه، أو إذا قمت بمحاولة إلى إضافة علامة تبويب باستخدام اسم موجود بالفعل.

Dataوسيطة، Visual C++يمكن للمستخدمين الوصول IUnknown IDataObject.

عند إضافة تجميعاً من Formatنوع vsToolBoxItemFormatDotNETComponent، القيمة التي تم تمريرها إلى Dataيمكن أن تكون معلمة في أحد التنسيقات التالية:

<AssemblyPath>— الموقع "<AssemblyPath>" عبارة عن مسار و ملف اسم الإشارة إلى تجميع التي تمت إدارتها مثلC:\Libraries\MyAssembly.dll. عندما كنت استخدم ذلك تنسيق، تتم تمت الإضافة الجميع فئات داخل.DLL إلى من مربع الأدوات.
<AssemblyNameInTheGAC>-clكـs واحد سرد كـ sembly كـ-المؤهلة المرجع. يمكن إضافة فئات مفردة كعناصر تحكم، شرط أن تكون مراجع إلى تجميع الذي هو في التجميع العمومي بالتخزين المؤقت (GAC)، مثل: WindowControlLibrary1.UserControl1, WindowControlLibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=<Your Token>. (سيتم استبدال <Your Token>مع رمز مفتاح عام الخاص بك، حيث هو المطلوبة لإضافة تجميع الخاص بك إلى GAC.)

أمثلة

يلي مثال يوضح كيفية إضافة مستند نصي إلى من مربع الأدوات:

Sub ToolBoxAddExample1()
    ' This adds a Text item to the first tab of the ToolBox.
    ' Define the variables and create an object reference to the IDE's  
    ' ToolBox object.
    Dim win As Window = DTE.Windows.Item(Constants.vsWindowKindToolbox)
    Dim tlbox As ToolBox = win.Object
    Dim tbxTabs As ToolBoxTabs

    ' Create an object reference to the ToolBoxTabs object.
    tbxTabs = tlbox.ToolBoxTabs

    ' Add a new Text item to the first tab in the ToolBox.
    tbxTabs.Item(1).ToolBoxItems.Add("New Text Item", "Some text to _
    add to the document.", vsToolBoxItemFormat.vsToolBoxItemFormatText)
End Sub

يلي مثال يوضح كيفية إضافة مكون.NET إلى من مربع الأدوات باستخدام مسار إلى الملف. مكوّن إلى إضافتها يجب أن يكون عنصر تحكم.NET، مثل Visual Basicمكون مكتبة التحكم Windows.

Sub ToolBoxItemAddExample2()
    Try
        Dim tlBox As ToolBox
        tlBox = CType(DTE.Windows.Item(Constants. _
        vsWindowKindToolbox).Object, EnvDTE.ToolBox)
        ' Create a new tab called "My Controls."
        Dim tlBoxTab As ToolBoxTab = tlBox.ToolBoxTabs. _
        Add("My Controls")
        ' Set focus to the new Toolbox tab.
        tlBoxTab.Activate()
        ' Add a .NET control as a new control in the new ToolBox tab. 
        ' The constant "vsToolBoxItemFormatDotNETComponent" alerts the 
        ' ToolBox to the type of control you are adding.
        tlBoxTab.ToolBoxItems.Add("MyDotNetControl", _
        "C:\Libraries\ADotNetControl.dll(", _
        vsToolBoxItemFormat.vsToolBoxItemFormatDotNETComponent)
    Catch ex As System.Exception
        ' Display any errors that occur.
        MsgBox("ERROR: " & ex.Message)
    End Try
End Sub

أمن NET Framework.

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