ControlExtensions.AddCheckBox – metoda (ControlCollection, Range, String)

Článek
01/03/2014

Přidá nový CheckBox listu v rozsahu určeném ovládacího prvku.

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

Syntaxe

'Deklarace
<ExtensionAttribute> _
Public Shared Function AddCheckBox ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As CheckBox

public static CheckBox AddCheckBox(
    this ControlCollection controls,
    Range range,
    string name
)

Parametry

controls
Typ: Microsoft.Office.Tools.Excel.ControlCollection
Kolekce přidat ovládací prvek.Nezadávejte tento parametr sami.Při volání této metody v kolekci vrácené Worksheet.Controls vlastnosti (v projektu úroveň aplikace) nebo WorksheetBase.Controls vlastnosti (v úrovni dokumentu projektu), tento parametr je zadán automaticky.

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

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

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.Controls.CheckBox
CheckBox Ovládací prvek, který byl přidán ControlCollection instance

Poznámka k použití

V jazycích Visual Basic a C# lze tuto metodu volat jako metodu instance libovolného objektu typu ControlCollection. Pokud k volání této metody použijete syntaxi metody instance, vynechejte první parametr. Další informace naleznete v tématech Metody rozšíření (Visual Basic) a Metody rozšíření (Průvodce programováním v C#).

Výjimky

Výjimka	Podmínka
ArgumentNullException	Argument název nebo rozsah 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	Určený rozsah je neplatný.Text rozsahy nelze použít.Rozsah by měl být na stejném listu jako ControlCollection instance.

Poznámky

AddCheckBox Metoda umožňuje přidat CheckBox objekty na konec ControlCollection.Odebrání CheckBox ovládací prvek, který byl dříve přidán programově, použijte Remove metoda.

Ovládací prvek automaticky přizpůsobí velikost při změně velikosti oblasti.

Příklady

Následující příklad kódu přidá CheckBox buňky ovládacího prvku A1a přidá do pole text.Chcete-li použít tento příklad, spusťte jej z Sheet1 třídy v projektu na úrovni dokumentu.

    Private Sub ExcelRangeAddCheckBox()

        Dim checkBox1 As Microsoft.Office.Tools.Excel. _
            Controls.CheckBox = Me.Controls.AddCheckBox( _
            Me.Range("A1"), "checkBox1")
        checkBox1.Text = "Underline"

    End Sub

private void ExcelRangeAddCheckBox()
{

    Microsoft.Office.Tools.Excel.Controls.CheckBox checkBox1 =
        this.Controls.AddCheckBox(this.Range["A1"], 
        "checkBox1");
    checkBox1.Text = "Underline";
}

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.

Viz také

Referenční dokumentace

ControlExtensions Třída

AddCheckBox – přetížení

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím