Metoda ControlExtensions.AddCheckedListBox — (ControlCollection, Double, Double, Double, Double, String)
Dodaje nowy CheckedListBox formantu arkusza określonego rozmiaru i lokalizacji.
Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestaw: Microsoft.Office.Tools.Excel.v4.0.Utilities (w Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Składnia
'Deklaracja
<ExtensionAttribute> _
Public Shared Function AddCheckedListBox ( _
controls As ControlCollection, _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As CheckedListBox
public static CheckedListBox AddCheckedListBox(
this ControlCollection controls,
double left,
double top,
double width,
double height,
string name
)
Parametry
- controls
Typ: Microsoft.Office.Tools.Excel.ControlCollection
Dodaj formant do kolekcji.Nie podano tego parametru samodzielnie.Gdy wywołanie tej metody dotyczące zbierania, zwrócony przez Worksheet.Controls właściwości (w projekcie na poziomie aplikacji) lub WorksheetBase.Controls właściwości (w projekcie poziomie dokumentu), ten parametr jest dostarczane automatycznie.
- left
Typ: System.Double
Odległość w punktach między lewą krawędzią formantu i lewej krawędzi arkusza.
- top
Typ: System.Double
Odległość w punktach między górną krawędzią formantu i górnej krawędzi arkusza.
- width
Typ: System.Double
Szerokość formantu znajdującego się w punktach.
- height
Typ: System.Double
Wysokość kontroli w punktach.
- name
Typ: System.String
Nazwa formantu.
Wartość zwracana
Typ: Microsoft.Office.Tools.Excel.Controls.CheckedListBox
CheckedListBox Formantu, który został dodany do ControlCollection instancji.
Informacje dotyczące użycia
W językach Visual Basic i C# tę metodę można wywołać jako metodę wystąpienia dowolnego obiektu typu ControlCollection. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr. Aby uzyskać więcej informacji, zobacz temat Metody rozszerzeń (Visual Basic) lub Metody rozszerzeń (Przewodnik programowania w języku C#).
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | Argument Nazwa 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 instancji. |
Uwagi
AddCheckedListBox Metoda umożliwia dodanie CheckedListBox obiekty do końca ControlCollection.Aby usunąć CheckedListBox formantu, który został wcześniej dodany programowo, użyj Remove metody.
Przykłady
Dodaje się następujący przykład kodu CheckedListBox kontroli do początku arkusza, dodawane są dwa elementy do pola listy sprawdzonej i następnie wybiera Pierwszego elementu pole wyboru.Aby wykorzystać ten przykład, należy uruchomić go z Sheet1 klasy w projekcie na poziomie dokumentu.
Private Sub ExcelAddCheckedListBox()
Dim CheckedListBox1 As Microsoft.Office.Tools. _
Excel.Controls.CheckedListBox = Me.Controls. _
AddCheckedListBox(0, 0, 90, 66.75, _
"CheckedListBox1")
CheckedListBox1.Items.Add("First Item")
CheckedListBox1.Items.Add("Second Item")
CheckedListBox1.SetItemChecked(0, True)
End Sub
private void ExcelAddCheckedListBox()
{
Microsoft.Office.Tools.Excel.Controls.CheckedListBox
checkedListBox1 = this.Controls.AddCheckedListBox(
0, 0, 90, 66.75, "checkedListBox1");
checkedListBox1.Items.Add("First Item");
checkedListBox1.Items.Add("Second Item");
checkedListBox1.SetItemChecked(0, true);
}
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.