Metoda ControlCollection.AddControl — (Control, Range, String)

Artykuł
01/08/2014

Dodaje określony Control do ControlCollection w określonym zakresie.

Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestawy: Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (w Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Składnia

'Deklaracja
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
Kontroli, które mają zostać dodane do ControlCollection wystąpienie.

range
Typ: Microsoft.Office.Interop.Excel.Range
A Range do celów kontroli i zapewniających granice.

name
Typ: System.String
Nazwa formantu, który może być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.

Wartość zwracana

Typ: Microsoft.Office.Tools.Excel.ControlSite
Obiekt, który reprezentuje formant zawierający określony formant w arkuszu.

Wyjątki

Wyjątek	Warunek
ArgumentNullException	Argument formantu, nazwa lub zakres jest nullodwołanie o wartości null (Nothing w języku Visual Basic), albo argumentu Nazwa ma zerową długość.
ControlNameAlreadyExistsException	Formant o tej samej nazwie jest już w ControlCollection wystąpienie.
InvalidRangeException	Określony zakres jest nieprawidłowy.Nie można użyć Multi-Area zakresów.Zakres powinien być na tym samym arkuszu co ControlCollection wystąpienie.

Uwagi

Ta metoda może służyć do dodawania dowolnego formantu do ControlCollection w czasie wykonywania.Aby uzyskać więcej informacji, zobacz Dodawanie formantów do dokumentów pakietu Office w czasie wykonywania.

Przykłady

Poniższy kod dodaje dwa formanty użytkownika niestandardowego do arkusza za pomocą AddControl metody.Pierwszy formant jest dodawany do zakresu komórek.Drugi formant jest dodawany do określonej lokalizacji.Zmiany w kodzie Top właściwość pierwszego formantu użytkownika niestandardowego, który porusza się tylko formantu względem ControlSite zawierający formant w arkuszu.Następnie ustawia kod Top właściwość ControlSite zwrócone przez drugi formant użytkownika do zilustrowania w prawidłowy sposób, aby ustawić Top właściwość formantu.

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

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.