ControlExtensions.AddMaskedTextBox (Método) (ControlCollection, Range, String)
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", missing], "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.