Metodo ControlExtensions.AddMaskedTextBox (ControlCollection, Double, Double, Double, Double, String)

Aggiunge un nuovo controllo MaskedTextBox al documento con le dimensioni e la posizione specificate.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
<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
)

Parametri

• controls
  Tipo: Microsoft.Office.Tools.Excel.ControlCollection
  Raccolta a cui aggiungere il controllo.Non fornire questo parametro.Quando questo metodo viene chiamato sulla raccolta restituita dalla proprietà Worksheet.Controls (in un progetto a livello di applicazione) o dalla proprietà WorksheetBase.Controls (in un progetto a livello di documento), questo parametro viene fornito automaticamente.

• left
  Tipo: System.Double
  Distanza, espressa in punti, tra il bordo sinistro del controllo e il bordo sinistro del documento.

• top
  Tipo: System.Double
  Distanza, espressa in punti, tra il bordo superiore del controllo e il bordo superiore del documento.

• width
  Tipo: System.Double
  Larghezza del controllo espressa in punti.

• height
  Tipo: System.Double
  Altezza del controllo espressa in punti.

• name
  Tipo: System.String
  Nome del controllo che può essere utilizzato per indicizzare il controllo nell'istanza di ControlCollection.

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.Controls.MaskedTextBox
Controllo MaskedTextBox aggiunto all'istanza di ControlCollection.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo ControlCollection. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

Note

Questo metodo consente di aggiungere oggetti MaskedTextBox alla fine dell'oggetto ControlCollection. Per rimuovere un oggetto MaskedTextBox aggiunto in precedenza a livello di codice, utilizzare il metodo Remove.

Esempi

Nell'esempio di codice riportato di seguito viene aggiunto un controllo MaskedTextBox alla parte superiore del foglio di lavoro, quindi viene impostata la proprietà Mask su 00/00/0000. Per utilizzare questo esempio, eseguirlo dalla classe Sheet1 in un progetto a livello di 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";
}

Sicurezza di .NET Framework

• Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ControlExtensions Classe

Overload AddMaskedTextBox

Spazio dei nomi Microsoft.Office.Tools.Excel