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

Adiciona um novo MaskedTextBox o controle para a planilha no intervalo especificado.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
<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
  A coleção para adicionar o controle.Não forneça esse parâmetro por conta própria.Quando você chama esse método na coleção retornada com o Worksheet.Controls propriedade (em um projeto de nível de aplicativo) ou o WorksheetBase.Controls propriedade (em um projeto de nível de documento), este parâmetro é fornecido automaticamente.

• range
  Tipo: Microsoft.Office.Interop.Excel.Range
  A Range que fornece o local para o controle.

• name
  Tipo: System.String
  O nome do controle que pode ser usado para indexar o controle no ControlCollection instância.

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.Controls.MaskedTextBox
O MaskedTextBox que foi adicionado ao controle de ControlCollection instância.

Observação de uso

No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo ControlCollection. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (guia de programação do C#).

Comentários

Esse método permite que você adicione MaskedTextBox objetos no final da ControlCollection.Para remover um MaskedTextBox que foi previamente adicionado programaticamente, use o Remove método.

Exemplos

O exemplo de código a seguir adiciona um MaskedTextBox o controle à célula A1e define o Mask propriedade para 00/00/0000.Para usar esse exemplo, executá-lo na Sheet1 classe em um projeto de nível 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";
}

Segurança do .NET Framework

• Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

ControlExtensions Classe

Sobrecargas AddMaskedTextBox

Namespace Microsoft.Office.Tools.Excel