ControlCollection.AddButton Method (Single, Single, Single, Single, String) (2003 System)

Adds a new Button control to the document in the specified size and location.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)


Public Function AddButton ( _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As Button
Dim instance As ControlCollection
Dim left As Single
Dim top As Single
Dim width As Single
Dim height As Single
Dim name As String
Dim returnValue As Button

returnValue = instance.AddButton(left, _
    top, width, height, name)
public Button AddButton(
    float left,
    float top,
    float width,
    float height,
    string name


  • left
    Type: System.Single
    The distance in pixels between the left edge of the control and the left edge of the document.
  • top
    Type: System.Single
    The distance in pixels between the top edge of the control and the top edge of the document.
  • height
    Type: System.Single
    The height of the control in pixels.

Return Value

Type: Microsoft.Office.Tools.Word.Controls.Button
The Button control that was added to the ControlCollection instance.


Exception Condition

The name argument is nulla null reference (Nothing in Visual Basic) or has zero length.


A control with the same name is already in the ControlCollection instance.


This method enables you to add Button objects to the end of the ControlCollection. To remove a Button that was previously added programmatically, use the Remove method.


The following code example adds a Button control to the start of the document, and then adds text to the button.

Private Sub WordAddButton()
    Dim button1 As Microsoft.Office.Tools.Word.Controls.Button _
        = Me.Controls.AddButton(0, 0, 56.25F, 17.25F, "Button1")
    button1.Text = "OK"

End Sub 

private void WordAddButton()
    Microsoft.Office.Tools.Word.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25F, 17.25F,
    button1.Text = "OK";


See Also


ControlCollection Class

ControlCollection Members

AddButton Overload

Microsoft.Office.Tools.Word Namespace