ControlExtensions.AddCheckedListBox – metoda (ControlCollection, Range, String)
Přidá nový CheckedListBox 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 AddCheckedListBox ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As CheckedListBox
public static CheckedListBox AddCheckedListBox(
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.CheckedListBox
CheckedListBox 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
AddCheckedListBox Metoda umožňuje přidat CheckedListBox objekty na konec ControlCollection.Odebrání CheckedListBox , byl již 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á CheckedListBox buňky ovládacího prvku A1 prostřednictvím B5, přidá do seznamu zaškrtnutá dvě položky a pak vybere první položku zaškrtávací políčko.Chcete-li použít tento příklad, spusťte jej z Sheet1 třídy v projektu na úrovni dokumentu.
Private Sub ExcelRangeAddCheckedListBox()
Dim CheckedListBox1 As Microsoft.Office.Tools. _
Excel.Controls.CheckedListBox = Me.Controls. _
AddCheckedListBox(Me.Range("A1", "B5"), _
"CheckedListBox1")
CheckedListBox1.Items.Add("First Item")
CheckedListBox1.Items.Add("Second Item")
CheckedListBox1.SetItemChecked(0, True)
End Sub
private void ExcelRangeAddCheckedListBox()
{
Microsoft.Office.Tools.Excel.Controls.CheckedListBox
checkedListBox1 = this.Controls.AddCheckedListBox(
this.Range["A1", "B5"], "checkedListBox1");
checkedListBox1.Items.Add("First Item");
checkedListBox1.Items.Add("Second Item");
checkedListBox1.SetItemChecked(0, true);
}
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.