ControlCollection.AddComboBox Method (Range, Single, Single, String) (2003 System)
Adds a new ComboBox 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)
Syntax
'Declaration
Public Function AddComboBox ( _
range As Range, _
width As Single, _
height As Single, _
name As String _
) As ComboBox
'Usage
Dim instance As ControlCollection
Dim range As Range
Dim width As Single
Dim height As Single
Dim name As String
Dim returnValue As ComboBox
returnValue = instance.AddComboBox(range, _
width, height, name)
public ComboBox AddComboBox(
Range range,
float width,
float height,
string name
)
Parameters
- range
Type: Microsoft.Office.Interop.Word.Range
A Range that provides the location for the control.
- width
Type: System.Single
The width of the control in pixels.
- height
Type: System.Single
The height of the control in pixels.
- name
Type: System.String
The name of the control that can be used to index the control in the ControlCollection instance.
Return Value
Type: Microsoft.Office.Tools.Word.Controls.ComboBox
The ComboBox control that was added to the ControlCollection instance.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | The name or range argument is nulla null reference (Nothing in Visual Basic), or the name argument has zero length. |
| ControlNameAlreadyExistsException | A control with the same name is already in the ControlCollection instance. |
| InvalidRangeException | The range that was specified is not valid. |
Remarks
This method enables you to add ComboBox objects to the end of the ControlCollection. To remove a ComboBox that was previously added programmatically, use the Remove method.
Examples
The following code example adds a ComboBox control to the first paragraph in the document, adds two items to the combo box, and then selects the first item.
Private Sub WordRangeAddComboBox()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim ComboBox1 As Microsoft.Office.Tools.Word.Controls. _
ComboBox = Me.Controls.AddComboBox(Me.Paragraphs(1). _
Range, 90.75F, 15.75F, "ComboBox1")
ComboBox1.Items.Add("First Item")
ComboBox1.Items.Add("Second Item")
ComboBox1.SelectedIndex = 0
End Sub
private void WordRangeAddComboBox()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Controls.ComboBox
comboBox1 = this.Controls.AddComboBox(
this.Paragraphs[1].Range, 90.75F, 15.75F, "comboBox1");
comboBox1.Items.Add("First Item");
comboBox1.Items.Add("Second Item");
comboBox1.SelectedIndex = 0;
}
Permissions
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.