ControlExtensions.AddCheckedListBox – metoda (ControlCollection, Range, Single, Single, String)

Článek
01/03/2014

Přidá nový CheckedListBox dokumentu ve velikosti a umístění ovládacího prvku.

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

Syntaxe

'Deklarace
<ExtensionAttribute> _
Public Shared Function AddCheckedListBox ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As CheckedListBox

public static CheckedListBox AddCheckedListBox(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

Parametry

controls
Typ: Microsoft.Office.Tools.Word.ControlCollection
Chcete-li přidat ovládací prvek do kolekce.Nezadávejte tento parametr sami.Při volání této metody v kolekci vrácené Document.Controls vlastnosti (v úrovni aplikace projektu) nebo DocumentBase.Controls vlastnosti (v úrovni dokumentu projekt), je tento parametr zadán automaticky.

range
Typ: Microsoft.Office.Interop.Word.Range
Umístění ovládacího prvku.

width
Typ: System.Single
Šířka ovládacího prvku v bodech.

height
Typ: System.Single
Výšku ovládacího prvku v bodech.

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

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.Controls.CheckedListBox
Ovládací prvek, který byl přidán do dokumentu.

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	name Nebo range argument je nullodkaz null (Nothing v jazyce Visual Basic), nebo name argument má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již ControlCollection instance.
InvalidRangeException	Zadaný rozsah je neplatný.

Poznámky

Tato metoda umožňuje přidat CheckedListBox objekty na konec ControlCollection.

Chcete-li odebrat CheckedListBox , byl přidán programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá CheckedListBox řízení prvního odstavce v dokumentu, přidá dvě položky zaškrtnuté seznamu a pak vybere První položka políčko.Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v úrovni dokumentu projekt.

Private Sub WordRangeAddCheckedListBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim CheckedListBox1 As Microsoft.Office.Tools.Word. _
        Controls.CheckedListBox = Me.Controls.AddCheckedListBox( _
        Me.Paragraphs(1).Range, 90, 66.75F, "CheckedListBox1")
    CheckedListBox1.Items.Add("First Item")
    CheckedListBox1.Items.Add("Second Item")
    CheckedListBox1.SetItemChecked(0, True)
End Sub

private void WordRangeAddCheckedListBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.CheckedListBox 
        checkedListBox1 = this.Controls.AddCheckedListBox(
        this.Paragraphs[1].Range, 90, 66.75F, "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.

Viz také

Referenční dokumentace

ControlExtensions Třída

AddCheckedListBox – přetížení

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

Sdílet prostřednictvím