ControlCollection.AddControl – metoda (Control, Range, String)

Článek
05/14/2013

Přidá zadaný Control se ControlCollection na zadaný rozsah.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

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

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

Parametry

control
Typ: System.Windows.Forms.Control
Ovládací prvek, který má být přidán k ControlCollection instance.

range
Typ: Microsoft.Office.Interop.Excel.Range
A Range , který poskytuje hranice ovládacího prvku.

name
Typ: System.String
Název ovládacího prvku, který lze použít k indexování ovládacího prvku v ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.ControlSite
Objekt, který představuje ovládací prvek, který obsahuje zadaný ovládací prvek na listu.

Výjimky

Výjimka	Podmínka
ArgumentNullException	Ovládací prvek, název nebo rozsah argument je nullodkaz null (Nothing v jazyce Visual Basic), nebo argument název má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již ControlCollection instance.
InvalidRangeException	Rozsah, který byl určen není platný.Nelze použít s rozsahy.Rozsah by měl být na stejném listu jako ControlCollection instance.

Poznámky

Tuto metodu lze použít libovolný ovládací prvek přidat ControlCollection v době běhu.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů sady Office v době spuštění.

Příklady

Následující příklad kódu přidá do listu pomocí dvou vlastních uživatelských ovládacích prvků AddControl metoda.První ovládací prvek je přidán do oblasti buněk.Druhý ovládací prvek je přidán do určitého umístění.Změny kódu Top vlastnost první vlastní uživatelský ovládací prvek, který pouze Posune ovládací prvek relativně ControlSite , která obsahuje ovládací prvek na listu.Kód potom nastaví Top vlastnost ControlSite vrácené druhý ovládací prvek uživatele ilustrovat správný způsob, jak nastavit Top vlastnost ovládacího prvku.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.