ControlExtensions.AddListBox Metoda

Definice

Přetížení

AddListBox(ControlCollection, Range, Single, Single, String)

Přidá nový ListBox ovládací prvek do dokumentu v zadané velikosti a umístění.

AddListBox(ControlCollection, Single, Single, Single, Single, String)

Přidá nový ListBox ovládací prvek do dokumentu v zadané velikosti a umístění.

AddListBox(ControlCollection, Range, Single, Single, String)

Přidá nový ListBox ovládací prvek do dokumentu v zadané velikosti a umístění.

public static Microsoft.Office.Tools.Word.Controls.ListBox AddListBox (this Microsoft.Office.Tools.Word.ControlCollection controls, Microsoft.Office.Interop.Word.Range range, float width, float height, string name);

Parametry

controls
ControlCollection

Kolekce, do které chcete přidat ovládací prvek. Nezadávejte tento parametr sami. Při volání této metody na kolekci vrácené Controls vlastností (v projektu na úrovni aplikace) nebo Controls vlastnosti (v projektu na úrovni dokumentu) je tento parametr zadán automaticky.

range
Range

Umístění ovládacího prvku

width
Single

Šířka ovládacího prvku v bodech

height
Single

Výška ovládacího prvku v bodech

name
String

Název, který lze použít k indexování ovládacího prvku v ControlCollection instanci.

Návraty

ListBox

Ovládací prvek, který byl přidán do dokumentu.

Výjimky

nameArgument or range je null , nebo name má argument nulovou délku.

V instanci již je ovládací prvek se stejným názvem ControlCollection .

Zadaný rozsah není platný.

Příklady

Následující příklad kódu přidá ListBox ovládací prvek do prvního odstavce v dokumentu, přidá dvě položky do pole seznam a pak vybere první položku. Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v projektu na úrovni dokumentu.

private void WordRangeAddListBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.ListBox
         listBox1 = this.Controls.AddListBox(
         this.Paragraphs[1].Range, 90, 71.25F, "lisBox1");
    listBox1.Items.Add("First Item");
    listBox1.Items.Add("Second Item");
    listBox1.SelectedIndex = 0;
}
Private Sub WordRangeAddListBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim ListBox1 As Microsoft.Office.Tools.Word.Controls. _
        ListBox = Me.Controls.AddListBox(Me.Paragraphs(1).Range, _
        90, 71.25F, "LisBox1")
    ListBox1.Items.Add("First Item")
    ListBox1.Items.Add("Second Item")
    ListBox1.SelectedIndex = 0
End Sub 

Poznámky

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

Chcete-li odebrat objekt ListBox , který byl přidán programově, použijte Remove metodu.

Platí pro

AddListBox(ControlCollection, Single, Single, Single, Single, String)

Přidá nový ListBox ovládací prvek do dokumentu v zadané velikosti a umístění.

public static Microsoft.Office.Tools.Word.Controls.ListBox AddListBox (this Microsoft.Office.Tools.Word.ControlCollection controls, float left, float top, float width, float height, string name);

Parametry

controls
ControlCollection

Kolekce, do které chcete přidat ovládací prvek. Nezadávejte tento parametr sami. Při volání této metody na kolekci vrácené Controls vlastností (v projektu na úrovni aplikace) nebo Controls vlastnosti (v projektu na úrovni dokumentu) je tento parametr zadán automaticky.

left
Single

Vzdálenost v bodech mezi levým okrajem ovládacího prvku a levým okrajem dokumentu.

top
Single

Vzdálenost v bodech mezi horním okrajem ovládacího prvku a horním okrajem dokumentu.

width
Single

Šířka ovládacího prvku v bodech

height
Single

Výška ovládacího prvku v bodech

name
String

Název, který lze použít k indexování ovládacího prvku v ControlCollection instanci.

Návraty

ListBox

Ovládací prvek, který byl přidán do dokumentu.

Výjimky

nameArgument má null hodnotu nebo má nulovou délku.

V instanci již je ovládací prvek se stejným názvem ControlCollection .

Příklady

Následující příklad kódu přidá ListBox ovládací prvek na začátek dokumentu, přidá dvě položky do pole seznam a pak vybere první položku. Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v projektu na úrovni dokumentu.

private void WordAddListBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.ListBox
         listBox1 = this.Controls.AddListBox(
         0, 0, 90, 71.25F, "lisBox1");
    listBox1.Items.Add("First Item");
    listBox1.Items.Add("Second Item");
    listBox1.SelectedIndex = 0;
}
Private Sub WordAddListBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim ListBox1 As Microsoft.Office.Tools.Word.Controls. _
        ListBox = Me.Controls.AddListBox(0, 0, 90, 71.25F, _
        "ListBox1")
    ListBox1.Items.Add("First Item")
    ListBox1.Items.Add("Second Item")
    ListBox1.SelectedIndex = 0
End Sub 

Poznámky

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

Chcete-li odebrat objekt ListBox , který byl přidán programově, použijte Remove metodu.

Platí pro