Condividi tramite

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

  • Articolo

Aggiunge il controllo specificato all'oggetto ControlCollection nella posizione e con le dimensioni specificate.

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

Sintassi

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

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

Parametri

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

Valore restituito

Tipo: Microsoft.Office.Tools.Word.ControlSite
Oggetto che rappresenta il controllo contenente il controllo specificato nel documento.

Eccezioni

Eccezione Condizione
ArgumentNullException

L'argomento di name è nullriferimento null (Nothing in Visual Basic), o argomento di name ha lunghezza zero.
ControlNameAlreadyExistsException

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

L'argomento control è nullriferimento null (Nothing in Visual Basic).

Note

Questo metodo può essere utilizzato per aggiungere un controllo 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 seguente vengono aggiunti al documento due controlli utente personalizzati mediante il metodo AddControl.Il primo controllo viene aggiunto a un oggetto Range.Il secondo controllo viene aggiunto a una posizione specifica.Viene modificata la proprietà Top del primo controllo utente personalizzato, spostando in tal modo il controllo solo in relazione all'oggetto ControlSite contenente il controllo nel documento.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 WordRangeAddControl()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim CustomUserControl As New UserControl1()
    Dim CustomUserControl2 As New UserControl2()

    Dim DynamicControl As Microsoft.Office.Tools.Word.ControlSite = _
        Me.Controls.AddControl(CustomUserControl, _
        Me.Paragraphs(1).Range, 150, 150, "DynamicControl")

    Dim DynamicControl2 As Microsoft.Office.Tools.Word.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 WordRangeAddControl()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    UserControl1 customUserControl = new UserControl1();
    UserControl2 customUserControl2 = new UserControl2();

    Microsoft.Office.Tools.Word.ControlSite dynamicControl =
        this.Controls.AddControl(customUserControl, 
        this.Paragraphs[1].Range, 150, 150, "dynamicControl");

    Microsoft.Office.Tools.Word.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.Word