ControlExtensions.AddNumericUpDown – metoda (ControlCollection, Single, Single, Single, Single, String)

Článek
01/03/2014

Přidá nový NumericUpDown 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 AddNumericUpDown ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As NumericUpDown

public static NumericUpDown AddNumericUpDown(
    this ControlCollection controls,
    float left,
    float top,
    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.

left
Typ: System.Single
Vzdálenost mezi levým okrajem ovládacího prvku a levým okrajem dokumentu bodů.

top
Typ: System.Single
Vzdálenost mezi horním okrajem ovládacího prvku a horním okrajem dokumentu bodů.

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.NumericUpDown
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 Argument je nullodkaz null (Nothing v jazyce Visual Basic) nebo má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již ControlCollection instance.

Poznámky

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

Chcete-li odebrat NumericUpDown ovládací prvek, který byl přidán programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá NumericUpDown řízení na začátek dokumentu a potom nastaví hodnotu 10.Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v úrovni dokumentu projekt.

Private Sub WordAddNumericUpDown()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim numericUpDown1 As Microsoft.Office.Tools.Word. _
        Controls.NumericUpDown = Me.Controls.AddNumericUpDown( _
        0, 0, 60, 15, "NumericUpDown1")
    numericUpDown1.Value = 10
End Sub

private void WordAddNumericUpDown()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.NumericUpDown
         numericUpDown1 = this.Controls.AddNumericUpDown(
         0, 0, 60, 15, "numericUpDown1");
    numericUpDown1.Value = 10;
}

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

AddNumericUpDown – přetížení

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

Sdílet prostřednictvím