ControlExtensions.AddListBox Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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
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.