Windows2.CreateToolWindow2 Yöntem

Makale
08/01/2011

Yeni bir araç penceresi oluşturur ve kullanıcı tanımlı barındırır.net denetiminde onu.

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
Bir örneği araç penceresinin oluþturulmasý içinde.

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 aracı 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 bulunan kullanıcı denetimi.

Dönüş Değeri

Tür: EnvDTE.Window
Window nesnesi

Açıklamalar

Ç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ışma için kaydolun projenin seçeneğinde derleme seçenekleri.) Bunu yapmazsanız, ardından Denetim doğru sıralama değil, ve CreateToolWindow2 döndürür null bir değer.

Görünürlük durumlarını yeni araç penceresini ayarlama girişimi — yükseklik ve genişlik gibi — araç penceresinde görüntülenen önce bir hata iletisi alıyorum. Pencere gibi özellikleri ayarlamak çalışmadan önce 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 kontrolü oluşturma.

Örnekler

Aşağıdaki örnek, ilk kullanıcı denetimi Windows Control Library projesi oluşturarak oluşturmanızı gerektirir. Aşağıdaki kodda kullanmak için denetimin proje ve sınıf adını not edin. Assemblypath dize kullanıcı denetiminin dll dosyasının dizini değiştirin. Ayrıca, kodunu değiştirmek için tasarlanmış 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;
}

.NET Framework Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. kısmen güvenilir kod tarafından Kitaplıklar kullanma.