ControlCollection.AddComboBox Метод (Range, Single, Single, String) (2007 System)
Обновлен: Ноябрь 2007
Добавляет в заданное место документа новый элемент управления ComboBox указанного размера.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)
Синтаксис
'Декларация
Public Function AddComboBox ( _
range As Range, _
width As Single, _
height As Single, _
name As String _
) As ComboBox
'Применение
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
)
Параметры
- range
Тип: Microsoft.Office.Interop.Word.Range
Объект Range, предоставляющий местоположение элемента управления.
- width
Тип: System.Single
Ширина элемента управления в пунктах.
- height
Тип: System.Single
Высота элемента управления в пунктах.
- name
Тип: System.String
Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.
Возвращаемое значение
Тип: Microsoft.Office.Tools.Word.Controls.ComboBox
Элемент управления ComboBox, добавленный в экземпляр класса ControlCollection.
Исключения
| Исключение | Условие |
|---|---|
| ArgumentNullException | Аргумент name или range равен nullссылка null (Nothing в Visual Basic), или аргумент name имеет нулевую длину. |
| ControlNameAlreadyExistsException | Элемент управления с таким именем уже имеется в данном экземпляре класса ControlCollection. |
| InvalidRangeException | Указанный диапазон не существует. |
Заметки
Этот метод используется для добавления объектов ComboBox в конец коллекции ControlCollection.
Чтобы удалить добавленный программно объект ComboBox, воспользуйтесь методом Remove.
Примеры
В приведенном ниже примере кода в первый абзац документа добавляется элемент управления ComboBox, после чего в поле со списком добавляются два элемента и выбирается первый из них.
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;
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.