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

Artykuł
01/08/2014

Dodaje określony Control do ControlCollection na lokalizację i rozmiar określony.

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, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As ControlSite

ControlSite AddControl(
    Control control,
    double left,
    double top,
    double width,
    double height,
    string name
)

Parametry

control
Typ: System.Windows.Forms.Control
Kontroli, które mają zostać dodane do ControlCollection wystąpienie.

left
Typ: System.Double
Odległość w punktach między lewą krawędzią formantu a lewą krawędzią arkusza.

top
Typ: System.Double
Odległość w punktach między górną krawędzią formantu a górną krawędzią arkusza.

width
Typ: System.Double
Szerokość formantu znajdującego się w punktach.

height
Typ: System.Double
Wysokość formantu w punktach.

name
Typ: System.String
Nazwa formantu.

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	Kontrola lub nazwę argumentu jest nullodwołanie o wartości null (Nothing w języku Visual Basic) lub ma zerową długość.
ControlNameAlreadyExistsException	Formant o tej samej nazwie jest już w 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.