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

Článek
08/11/2011

Přidá nový MaskedTextBox řízení v rozsahu určeném listu.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Deklarace
<ExtensionAttribute> _
Public Shared Function AddMaskedTextBox ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As MaskedTextBox

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

Parametry

controls
Typ: Microsoft.Office.Tools.Excel.ControlCollection
kolekce přidat ovládací prvek.Nezadávejte tento parametr sami.Při volání této metody ve vrácené kolekci Worksheet.Controls Vlastnosti (v úrovni aplikace project) nebo WorksheetBase.Controls Vlastnosti (v úrovni dokumentu projektu) je tento parametr zadán automaticky.

range
Typ: Microsoft.Office.Interop.Excel.Range
A Range , který poskytuje umístění pro ovládací prvek.

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

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.Controls.MaskedTextBox
MaskedTextBox Ovládací prvek, který byl přidán ControlCollection instance.

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 Extension Methods (Visual Basic) a Extension Methods (C# Programming Guide).

Poznámky

Tato metoda umožňuje přidat MaskedTextBox objekty na konci ControlCollection. Odebrání MaskedTextBox , byl již přidán programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá MaskedTextBox řízení buňky A1a poté nastaví Mask vlastnost 00, 00/0000. Chcete-li použít tento příklad spustit z Sheet1 třídy v projektu úrovni dokumentu.

    Private Sub ExcelRangeAddMaskedTextBox()

        Dim MaskedTextBox1 As Microsoft.Office.Tools. _
            Excel.Controls.MaskedTextBox = Me.Controls. _
            AddMaskedTextBox(Me.Range("A1"), "MaskedTextBox1")

        MaskedTextBox1.Mask = "00/00/0000"

    End Sub

private void ExcelRangeAddMaskedTextBox()
{

    Microsoft.Office.Tools.Excel.Controls.MaskedTextBox
         maskedTextBox1 = this.Controls.AddMaskedTextBox(
        this.Range["A1", missing], "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.