ControlCollection.AddControl Yöntem (Control, Range, String)

Makale
08/01/2011

Belirtilen ekler Control için ControlCollection belirtilen aralık.

Ad alanı: Microsoft.Office.Tools.Excel
Derleme: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll içinde)

Sözdizimi

'Bildirim
Function AddControl ( _
    control As Control, _
    range As Range, _
    name As String _
) As ControlSite

ControlSite AddControl(
    Control control,
    Range range,
    string name
)

Parametreler

control
Tür: System.Windows.Forms.Control
Eklenecek denetim ControlCollection örneği.

range
Tür: Microsoft.Office.Interop.Excel.Range
A Range sınırları için denetim sağlar

name
Tür: System.String
Denetimde dizin oluşturmak için kullanılan denetimin adını ControlCollection örneği.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Excel.ControlSite
Çalışma sayfasında belirtilen denetim içeren denetimi temsil eden nesne.

Özel Durumlar

Exception	Koşul
ArgumentNullException	Denetim, ad veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic\'te Nothing), veya adı bağımsız değişkeni sıfır uzunluk.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim söz ControlCollection örneği.
InvalidRangeException	Belirtilen aralık geçerli değil. Multi-Area aralıkları kullanılamaz. Aralık aynı çalışma sayfasında olması ControlCollection örneği.

Açıklamalar

Bu yöntem, herhangi bir denetimi eklemek için kullanılabilir ControlCollection çalışma süresi. Daha fazla bilgi için bkz. Belgeye Çalışma Zamanında Denetim Ekleme.

Örnekler

Aşağıdaki kod örneği, çalışma sayfasını kullanarak iki özel kullanıcı denetimi ekler AddControl yöntemi. İlk denetim bir hücre aralığına eklenir. İkinci denetimin belirli bir konuma eklenir. Kod değişiklikleri Top yalnızca denetimi taşır ilk özel kullanıcı denetimin özelliğine göre ControlSite çalışma denetimini içeren Kod daha sonra ayarlar Top özelliği ControlSite en doğru yolu göstermek için ikinci kullanıcı denetimi tarafından döndürülen Top özellik denetimi.

    Private Sub ExcelRangeAddControl()

        Dim CustomUserControl As New UserControl1()
        Dim CustomUserControl2 As New UserControl2()

        Dim DynamicControl As Microsoft.Office.Tools.Excel.ListObject = Me.Controls.AddControl( _
            CustomUserControl, 0, 0, 150, 150, _
            "DynamicControl")

        Dim DynamicControl2 As Microsoft.Office.Tools.Excel. _
            ControlSite = Me.Controls.AddControl( _
            CustomUserControl2, 200, 0, 150, 150, _
            "DynamicControl2")

        CustomUserControl.BackColor = Color.Blue
        CustomUserControl2.BackColor = Color.Green

        CustomUserControl.Top = 100
        DynamicControl2.Top = 100

    End Sub

private void ExcelRangeAddControl()
{

    UserControl1 customUserControl = new UserControl1();
    UserControl2 customUserControl2 = new UserControl2();

    Microsoft.Office.Tools.Excel.ControlSite dynamicControl =
        this.Controls.AddControl(customUserControl,
        0, 0, 150, 150, "dynamicControl");

    Microsoft.Office.Tools.Excel.ControlSite dynamicControl2 =
        this.Controls.AddControl(customUserControl2, 200, 0,
        150, 150, "dynamicControl2");

    customUserControl.BackColor = Color.Blue;
    customUserControl2.BackColor = Color.Green;

    customUserControl.Top = 100;
    dynamicControl2.Top = 100;
}

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