Windows2.CreateToolWindow2 Yöntem

Makale
10/29/2012

Yeni bir araç penceresi oluşturur ve kullanıcı tanımlı barındırır.net denetim içindeki.

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

Sözdizimi

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

Parametreler

Addin
Tür: EnvDTE.AddIn
Araç penceresinin oluþturulmasý,'ın bir örneği.

Assembly
Tür: System.String
Tam adı veya kullanıcı denetimi içeren derleme dosyasının yolu.

Class
Tür: System.String
Kullanıcı denetimi uygulayan sýnýfýn tam adı.

Caption
Tür: System.String
Yeni araç penceresinde görüntülenecek başlık.

GuidPosition
Tür: System.String
Yeni pencere için benzersiz bir tanımlayıcı.(Bu pencerede bulmak için kullanılabilir Windows koleksiyonu.)

ControlObject
Tür: System.Object%
Yeni aracı penceresinde barındırılması için kullanıcı denetimi.

Dönüş Değeri

Tür: EnvDTE.Window
Window nesnesi

Notlar

Çağırma önce CreateToolWindow2 yeni bir araç penceresi oluşturmak için ya da kullanıcı denetimi taşımak (ControlObject) COM tümüyle görünür hale getirmek için ayný montaj eklenti veya ayarlanmış tüm öznitelikler kullanıcı denetimi içine(Örneğin, denetleme com birlikte çalışabilirlik için kaydolun projenin seçeneğinde derleme seçenekleri.) Bunu yapmazsanız, ardından Denetim doğru sıralama değil, ve CreateToolWindow2 bir null değeri döndürür.

Yeni araç penceresinin görünürlük durumlarını ayarlama girişiminde — yükseklik ve genişlik gibi — araç penceresi görünür önce bir hata iletisi alıyorum.Bu tür özelliklerini ayarlamak çalışmadan önce pencere görünür olduğundan emin olun.

Üzerinde bu yöntemin nasıl kullanılacağı ile ilgili daha fazla örnek görmek için ToolWindow örnek Visual Studio Otomasyon örnekleri Web sayfası: https://www.microsoft.com/downloads/details.aspx?familyid=3ff9c915-30e5-430e-95b3-621dccd25150 & displaylang = tr.ActiveX denetimleri oluşturma hakkında daha fazla bilgi için bkz: Bir mfc ActiveX denetimini oluþturmak.

Örnekler

Aşağıdaki örnek, Windows Control Library projesi oluşturarak bir kullanıcı denetimi ilk oluşturmanızı gerektirir.Aşağıdaki kodda kullanmak için denetimin proje ve sınıf adını not alın.Assemblypath dize kullanıcı denetiminin dll dosyasının dizini değiştirin.Ayrıca, kod yerini almak üzere tasarlanmıştır OnConnection yöntemi, bir eklenti projesi.

[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;
}