ControlExtensions.AddMaskedTextBox (Método) (ControlCollection, Range, String)

Artículo
05/15/2013

Agrega a la hoja de cálculo un nuevo control MaskedTextBox en el rango especificado.

Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxis

'Declaración
<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
)

Parámetros

controls
Tipo: Microsoft.Office.Tools.Excel.ControlCollection
Colección a la que se va a agregar el control.No proporcione este parámetro personalmente.Cuando se llama a este método en la colección devuelta por la propiedad Worksheet.Controls (en un proyecto de nivel de aplicación) o la propiedad WorksheetBase.Controls (en un proyecto de nivel de documento), este parámetro se proporciona automáticamente.

range
Tipo: Microsoft.Office.Interop.Excel.Range
Objeto Range que proporciona la ubicación del control.

name
Tipo: System.String
Nombre del control que puede utilizarse para indizar el control en la instancia de ControlCollection.

Valor devuelto

Tipo: Microsoft.Office.Tools.Excel.Controls.MaskedTextBox
Control MaskedTextBox agregado a la instancia del objeto ControlCollection.

Nota sobre el uso

En Visual Basic y C#, se puede llamar a este método como a un método de instancia en cualquier objeto de tipo ControlCollection. Cuando emplee la sintaxis del método de instancia para llamar a este método, omita el primer parámetro. Para obtener más información, vea Métodos de extensión (Visual Basic) o Métodos de extensión (Guía de programación de C#).

Comentarios

Este método permite agregar objetos MaskedTextBox al final de ControlCollection.Para quitar un control MaskedTextBox agregado previamente mediante programación, utilice el método Remove.

Ejemplos

En el siguiente ejemplo de código se agrega un control MaskedTextBox a la celda A1 y, a continuación, se establece la propiedad Mask en 00/00/0000.Para usar este ejemplo, ejecútelo desde la clase Sheet1 en un proyecto de nivel de documento.

    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"], "maskedTextBox1");
    maskedTextBox1.Mask = "00/00/0000";
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.