مشاركة عبر

Windows2.CreateToolWindow2 أسلوب

  • مقالة

يقوم بإنشاء أداة جديدة الإطار والمضيفين مستخدم المعرفة، التحكم.NET بداخلها.

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

بناء الجملة

'إقرار
Function CreateToolWindow2 ( _
    Addin As AddIn, _
    Assembly As String, _
    Class As String, _
    Caption As String, _
    GuidPosition As String, _
    <OutAttribute> ByRef ControlObject As Object _
) As Window

Window CreateToolWindow2(
    AddIn Addin,
    string Assembly,
    string Class,
    string Caption,
    string GuidPosition,
    out Object ControlObject
)

Window^ CreateToolWindow2(
    AddIn^ Addin, 
    String^ Assembly, 
    String^ Class, 
    String^ Caption, 
    String^ GuidPosition, 
    [InAttribute] [OutAttribute] Object^% ControlObject
)

abstract CreateToolWindow2 : 
        Addin:AddIn * 
        Assembly:string * 
        Class:string * 
        Caption:string * 
        GuidPosition:string * 
        ControlObject:Object byref -> Window 

function CreateToolWindow2(
    Addin : AddIn, 
    Assembly : String, 
    Class : String, 
    Caption : String, 
    GuidPosition : String, 
    ControlObject : Object
) : Window

المعلمات

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

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

ملاحظات

قبل استدعاء CreateToolWindow2لإنشاء نافذة جديد لأداة، يجب أما تحريك عنصر التحكم مستخدم ( ControlObject) في نفس تجميع إضافة-في، أو تعيين كل من الالسمات تشغيل عنصر التحكم مستخدم لجعله مرئياً بشكل كامل إلى COM. (ل مثال، يتم الآن التدقيق من تسجيل ل توافق COM خيار في مشروع الترجمة بخيارات.) إذا لم تقم بذلك، ثم عنصر تحكم سوف لا يتم تنظيم بشكل صحيح CreateToolWindow2بإرجاع القيمة خالية.

إذا حاولت تعيين كيفية ظهور حالات أداة جديدة إطار — مثل ارتفاع أو عرض موضع — قبل ظهور إطار أداة، تحصل على خطأ. Make sure that the نافذة هو مرئي قبل attempting إلى التعيين أي such خصائص.

للحصول تشغيل المزيد من الأمثلة حول إلى استخدام هذه الطريقة، راجع العينة إلى olWindow تشغيل Visual Studioصفحة ويب ‏‫النماذج Auإلىmation: https://www.microsoft.com/التنزيلات/تفاصيل.aspx?familyid=3ff9c915-30e5-430e-95b3-621dccd25150 & displaylang = قصيرة. لمعلومات حول إنشاء عناصر تحكم ActiveX، راجع إنشاء عنصر تحكم MFC ActiveX.

أمثلة

المثال التالي يتطلب أن تقوم أول قم بإنشاء عنصر تحكم مستخدم بواسطة إنشاء مشروع مكتبة التحكم Windows. لاحظ اسم مشروع وفئة عنصر التحكم للاستخدام في ما يلي تعليمات برمجية. تغيير السلسلة assemblypath إلى الدليل ملف مكتبة الارتباط الديناميكي الخاصة بعنصر التحكم للمستخدم. وكذلك التعليمات البرمجية هو تصميمه لاستبدال OnConnectionأسلوب على الوظيفة الإضافية في مشروع.

[#C]

public void OnConnection(object application, ext_ConnectMode 
  connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    EnvDTE80.Windows2 wins2obj;
    AddIn addinobj;
    object ctlobj = null;
    Window newWinobj;

    // A toolwindow must be connected to an add-in, so this line 
    // references one.
    addinobj = _applicationObject.AddIns.Item(1);
    wins2obj = (Windows2)_applicationObject.Windows;

    // This section specifies the path and class name of the windows 
    // control that you want to host in the new tool window, as well as 
    // its caption and a unique GUID.
    string assemblypath = "C:\\temp\\WindowsControlLibrary1.dll";
    string classname = "WindowsControlLibrary1.UserControl1";
    string guidpos = "{426E8D27-3D33-4FC8-B3E9-9883AADC679F}";
    string caption = "CreateToolWindow2 Test";

    // Create the new tool window and insert the user control in it.
    newWinobj = wins2obj.CreateToolWindow2(addinobj, assemblypath, 
      classname, caption, guidpos, ref ctlobj);
    newWinobj.Visible = true;
}

أمن NET Framework.

راجع أيضًَا

المرجع

Windows2 واجهة

Windows2 الأعضاء

EnvDTE80 مساحة الاسم

موارد أخرى

كيفية: إنشاء "و" التحكم في Windows أداة

كيفية: الترجمة وإعادة تشغيل أمثلة التعليمات البرمجية لطراز كائن التنفيذ التلقائي