ControlExtensions.AddButton Metoda

Definice

Přetížení

AddButton(ControlCollection, Range, Single, Single, String)

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

AddButton(ControlCollection, Single, Single, Single, Single, String)

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

AddButton(ControlCollection, Range, Single, Single, String)

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

public static Microsoft.Office.Tools.Word.Controls.Button AddButton (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

Button

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

Výjimky

nameArgument or range je null , nebo má argument name 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á Button ovládací prvek do prvního odstavce v dokumentu a následně přidá text na tlačítko. Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v projektu na úrovni dokumentu.

private void WordRangeAddButton()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.Button button1 =
        this.Controls.AddButton(this.Paragraphs[1].Range,
        56.25F, 17.25F, "button1");
    button1.Text = "OK";
}
Private Sub WordRangeAddButton()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Button1 As Microsoft.Office.Tools.Word.Controls.Button _
        = Me.Controls.AddButton(Me.Paragraphs(1).Range, 56.25F, _
        17.25F, "Button1")
    Button1.Text = "OK"
End Sub 

Poznámky

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

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

Platí pro

AddButton(ControlCollection, Single, Single, Single, Single, String)

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

public static Microsoft.Office.Tools.Word.Controls.Button AddButton (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

Button

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á Button ovládací prvek na začátek dokumentu a pak přidá text na tlačítko. Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v projektu na úrovni dokumentu.

private void WordAddButton()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25F, 17.25F,
        "button1");
    button1.Text = "OK";
}
Private Sub WordAddButton()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim button1 As Microsoft.Office.Tools.Word.Controls.Button _
        = Me.Controls.AddButton(0, 0, 56.25F, 17.25F, "Button1")
    button1.Text = "OK"
End Sub 

Poznámky

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

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

Platí pro