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

Článek
05/14/2013

Přidá novou MaskedTextBox dokument v určené 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 AddMaskedTextBox ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As MaskedTextBox

public static MaskedTextBox AddMaskedTextBox(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

Parametry

controls
Typ: Microsoft.Office.Tools.Word.ControlCollection
Kolekce pro přidání ovládacího prvku.Nezadávejte tento parametr sami.Při volání této metody v kolekci vrácenou Document.Controls vlastností (v projektu aplikace application-level) nebo DocumentBase.Controls vlastnosti (v úrovni dokumentů projektu), je tento parametr zadán automaticky.

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

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

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

name
Typ: System.String
Název, který lze použít k indexování ovládacího prvku v ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.Controls.MaskedTextBox
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 Rozšíření metody (Visual Basic) a Rozšíření metody (Příručka programování C#).

Poznámky

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

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

Příklady

Následující příklad kódu přidává MaskedTextBox první odstavec v dokumentu a poté nastaví vlastnost ovládacího prvku Mask vlastnost 00, 00/0000.Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v projektu na úrovni dokumentu.

Private Sub WordRangeAddMaskedTextBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim MaskedTextBox1 As Microsoft.Office.Tools.Word. _
        Controls.MaskedTextBox = Me.Controls.AddMaskedTextBox( _
        Me.Paragraphs(1).Range, 75, 15, "MaskedTextBox1")
    MaskedTextBox1.Mask = "00/00/0000"
End Sub

private void WordRangeAddMaskedTextBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.MaskedTextBox
         maskedTextBox1 = this.Controls.AddMaskedTextBox(
         this.Paragraphs[1].Range, 75, 15, "maskedTextBox1");
    maskedTextBox1.Mask = "00/00/0000";
}

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.