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

Adiciona um novo MaskedTextBox o controle para o documento em que o tamanho especificado e o local.

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, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As MaskedTextBox

public static MaskedTextBox AddMaskedTextBox(
    this ControlCollection controls,
    double left,
    double top,
    double width,
    double height,
    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 sozinho.Quando você chamar 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.

• left
  Tipo: System.Double
  A distância em pontos entre a borda esquerda do controle e a borda esquerda do documento.

• top
  Tipo: System.Double
  A distância em pontos entre a borda superior do controle e a borda superior do documento.

• width
  Tipo: System.Double
  A largura do controle em pontos.

• height
  Tipo: System.Double
  A altura do controle em pontos.

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

Valor de retorno

Tipo: Microsoft.Office.Tools.Excel.Controls.MaskedTextBox
O MaskedTextBox controle foi adicionado para o 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 TRANSLATION FROM VPE FOR CSHARP).

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 controle na parte superior da planilha e conjuntos de Mask propriedade para 00/00/0000. Para usar esse exemplo, executá-lo do Sheet1 a classe em um projeto de nível de documento.

    Private Sub ExcelAddMaskedTextBox()

        Dim MaskedTextBox1 As Microsoft.Office.Tools. _
            Excel.Controls.MaskedTextBox = Me.Controls. _
            AddMaskedTextBox(0, 0, 75, 15, "MaskedTextBox1")
        MaskedTextBox1.Mask = "00/00/0000"

    End Sub

private void ExcelAddMaskedTextBox()
{

    Microsoft.Office.Tools.Excel.Controls.MaskedTextBox
         maskedTextBox1 = this.Controls.AddMaskedTextBox(
         0, 0, 75, 15, "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