Share via

Metodo ControlCollection.AddControl (Control, Double, Double, Double, Double, String)

  • Articolo

Aggiunge l'oggetto Control specificato all'oggetto ControlCollection con le dimensioni e la posizione specificate.

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

Sintassi

'Dichiarazione
Function AddControl ( _
    control As Control, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As ControlSite

ControlSite AddControl(
    Control control,
    double left,
    double top,
    double width,
    double height,
    string name
)

Parametri

  • left
    Tipo: System.Double
    Distanza, espressa in punti, tra il bordo sinistro del controllo e il bordo sinistro del foglio di lavoro.
  • top
    Tipo: System.Double
    Distanza, espressa in punti, tra il bordo superiore del controllo e il bordo superiore del foglio di lavoro.
  • width
    Tipo: System.Double
    Larghezza del controllo espressa in punti.
  • height
    Tipo: System.Double
    Altezza del controllo espressa in punti.

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.ControlSite
Oggetto che rappresenta il controllo contenente il controllo specificato nel foglio di lavoro.

Eccezioni

Eccezione Condizione
ArgumentNullException

L'argomento relativo al controllo o al nome è nullriferimento null (Nothing in Visual Basic) oppure ha lunghezza zero.
ControlNameAlreadyExistsException

Nell'istanza di ControlCollection è già presente un controllo con lo stesso nome.

Note

È possibile utilizzare questo metodo per aggiungere un controllo qualsiasi all'oggetto ControlCollection in fase di esecuzione.Per ulteriori informazioni, vedere Aggiunta di controlli ai documenti di Office in fase di esecuzione.

Esempi

Nell'esempio di codice riportato di seguito vengono aggiunti due controlli utente personalizzati al foglio di lavoro utilizzando il metodo AddControl.Il primo controllo viene aggiunto a un intervallo di celle.Il secondo controllo viene aggiunto a una posizione specifica.Il codice modifica la proprietà Top del primo controllo utente personalizzato, la quale sposta solo il controllo relativo all'oggetto ControlSite che contiene il controllo nel foglio di lavoro.Il codice imposta quindi la proprietà Top dell'oggetto ControlSite restituito dal secondo controllo utente personalizzato per indicare la corretta impostazione della proprietà Top del controllo.

    Private Sub ExcelRangeAddControl()

        Dim CustomUserControl As New UserControl1()
        Dim CustomUserControl2 As New UserControl2()

        Dim DynamicControl As Microsoft.Office.Tools.Excel.ListObject = Me.Controls.AddControl( _
            CustomUserControl, 0, 0, 150, 150, _
            "DynamicControl")

        Dim DynamicControl2 As Microsoft.Office.Tools.Excel. _
            ControlSite = Me.Controls.AddControl( _
            CustomUserControl2, 200, 0, 150, 150, _
            "DynamicControl2")

        CustomUserControl.BackColor = Color.Blue
        CustomUserControl2.BackColor = Color.Green

        CustomUserControl.Top = 100
        DynamicControl2.Top = 100

    End Sub


private void ExcelRangeAddControl()
{

    UserControl1 customUserControl = new UserControl1();
    UserControl2 customUserControl2 = new UserControl2();

    Microsoft.Office.Tools.Excel.ControlSite dynamicControl =
        this.Controls.AddControl(customUserControl,
        0, 0, 150, 150, "dynamicControl");

    Microsoft.Office.Tools.Excel.ControlSite dynamicControl2 =
        this.Controls.AddControl(customUserControl2, 200, 0,
        150, 150, "dynamicControl2");

    customUserControl.BackColor = Color.Blue;
    customUserControl2.BackColor = Color.Green;

    customUserControl.Top = 100;
    dynamicControl2.Top = 100;
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

ControlCollection Interfaccia

Overload AddControl

Spazio dei nomi Microsoft.Office.Tools.Excel