ControlCollection - интерфейс
Представляет коллекцию управляемых элементов управления на листе Excel в решении Office.
Пространство имен: Microsoft.Office.Tools.Excel
Сборки: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Синтаксис
'Декларация
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
Inherits IEnumerable
[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable
Тип ControlCollection предоставляет следующие члены.
Свойства
| Имя | Описание | |
|---|---|---|
.gif "Открытое свойство") |
Count | Получает число элементов управления в объекте ControlCollection. |
|
Item[Int32] | Возвращает элемент управления по указанному индексу. |
|
Item[String] | Возвращает элемент управления с указанным именем. |
В начало страницы
Методы
| Имя | Описание | |
|---|---|---|
.gif "Открытый метод") |
_VtblGap1_5 | Инфраструктура. |
|
AddChart(Range, String) | Добавляет новый элемент управления Chart в указанный диапазон листа. |
|
AddChart(Double, Double, Double, Double, String) | Добавляет в заданное место листа новый элемент управления Chart указанного размера. |
|
AddControl(Control, Range, String) | Добавляет определенный Control в ControlCollection в определенном диапазоне. |
|
AddControl(Control, Double, Double, Double, Double, String) | Добавляет заданный Control указанного размера в заданное место ControlCollection. |
|
AddListObject(ListObject) | Добавляет объект Microsoft.Office.Tools.Excel.ListObject Visual Studio в коллекцию элементов управления, основанную на указанном собственном объекте Microsoft.Office.Interop.Excel.ListObject. |
|
AddListObject(Range, String) | Добавляет в заданный диапазон листа новый элемент управления ListObject. |
|
AddNamedRange | Добавляет в заданный диапазон листа новый элемент управления NamedRange. |
|
Contains(Object) | Определяет, входит ли указанный элемент управления в экземпляр коллекции ControlCollection. |
|
Contains(String) | Определяет, входит ли элемент управления с указанным именем в экземпляр коллекции ControlCollection. |
|
GetEnumerator | Возвращает перечислитель, осуществляющий перебор коллекции. (Унаследовано от IEnumerable.) |
|
IndexOf(Object) | Выполняет поиск указанного элемента управления и возвращает индекс (отсчитываемый с нуля) первого вхождения элемента управления в экземпляре коллекции ControlCollection. |
|
IndexOf(String) | Выполняет поиск первого вхождения элемента управления с указанным именем в экземпляре коллекции ControlCollection. |
|
Remove(Object) | Удаляет заданный элемент управления из экземпляра ControlCollection. |
|
Remove(String) | Удаляет элемент управления с заданным именем из экземпляра ControlCollection. |
|
RemoveAt | Удаляет элемент управления по указанному индексу из экземпляра ControlCollection. |
В начало страницы
Методы расширения
| Имя | Описание | |
|---|---|---|
.gif "Открытый метод расширения") |
AddButton(Range, String) | Перегружен. Добавляет новый элемент управления Button в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddButton(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления Button указанного размера. (Определено в ControlExtensions.) |
|
AddCheckBox(Range, String) | Перегружен. Добавляет новый элемент управления CheckBox в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddCheckBox(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления CheckBox указанного размера. (Определено в ControlExtensions.) |
|
AddCheckedListBox(Range, String) | Перегружен. Добавляет новый элемент управления CheckedListBox в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddCheckedListBox(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления CheckedListBox указанного размера. (Определено в ControlExtensions.) |
|
AddComboBox(Range, String) | Перегружен. Добавляет новый элемент управления ComboBox в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddComboBox(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления ComboBox указанного размера. (Определено в ControlExtensions.) |
|
AddDataGridView(Range, String) | Перегружен. Добавляет новый элемент управления DataGridView в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddDataGridView(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления DataGridView указанного размера. (Определено в ControlExtensions.) |
|
AddDateTimePicker(Range, String) | Перегружен. Добавляет новый элемент управления DateTimePicker в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddDateTimePicker(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления DateTimePicker указанного размера. (Определено в ControlExtensions.) |
|
AddDomainUpDown(Range, String) | Перегружен. Добавляет новый элемент управления DomainUpDown в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddDomainUpDown(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления DomainUpDown указанного размера. (Определено в ControlExtensions.) |
|
AddHScrollBar(Range, String) | Перегружен. Добавляет новый элемент управления HScrollBar в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddHScrollBar(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления HScrollBar указанного размера. (Определено в ControlExtensions.) |
|
AddLabel(Range, String) | Перегружен. Добавляет новый элемент управления Label в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddLabel(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления Label указанного размера. (Определено в ControlExtensions.) |
|
AddLinkLabel(Range, String) | Перегружен. Добавляет новый элемент управления LinkLabel в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddLinkLabel(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления LinkLabel указанного размера. (Определено в ControlExtensions.) |
|
AddListBox(Range, String) | Перегружен. Добавляет новый элемент управления ListBox в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddListBox(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления ListBox указанного размера. (Определено в ControlExtensions.) |
|
AddListView(Range, String) | Перегружен. Добавляет новый элемент управления ListView в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddListView(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления ListView указанного размера. (Определено в ControlExtensions.) |
|
AddMaskedTextBox(Range, String) | Перегружен. Добавляет новый элемент управления MaskedTextBox в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddMaskedTextBox(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение документа новый элемент управления MaskedTextBox указанного размера. (Определено в ControlExtensions.) |
|
AddMonthCalendar(Range, String) | Перегружен. Добавляет новый элемент управления MonthCalendar в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddMonthCalendar(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления MonthCalendar указанного размера. (Определено в ControlExtensions.) |
|
AddNumericUpDown(Range, String) | Перегружен. Добавляет новый элемент управления NumericUpDown в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddNumericUpDown(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления NumericUpDown указанного размера. (Определено в ControlExtensions.) |
|
AddPictureBox(Range, String) | Перегружен. Добавляет новый элемент управления PictureBox в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddPictureBox(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления PictureBox указанного размера. (Определено в ControlExtensions.) |
|
AddProgressBar(Range, String) | Перегружен. Добавляет новый элемент управления ProgressBar в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddProgressBar(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления ProgressBar указанного размера. (Определено в ControlExtensions.) |
|
AddPropertyGrid(Range, String) | Перегружен. Добавляет новый элемент управления PropertyGrid в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddPropertyGrid(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления PropertyGrid указанного размера. (Определено в ControlExtensions.) |
|
AddRadioButton(Range, String) | Перегружен. Добавляет новый элемент управления RadioButton в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddRadioButton(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления RadioButton указанного размера. (Определено в ControlExtensions.) |
|
AddRichTextBox(Range, String) | Перегружен. Добавляет новый элемент управления RichTextBox в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddRichTextBox(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления RichTextBox указанного размера. (Определено в ControlExtensions.) |
|
AddTextBox(Range, String) | Перегружен. Добавляет новый элемент управления TextBox в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddTextBox(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления TextBox указанного размера. (Определено в ControlExtensions.) |
|
AddTrackBar(Range, String) | Перегружен. Добавляет новый элемент управления TrackBar в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddTrackBar(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления TrackBar указанного размера. (Определено в ControlExtensions.) |
|
AddTreeView(Range, String) | Перегружен. Добавляет новый элемент управления TreeView в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddTreeView(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления TreeView указанного размера. (Определено в ControlExtensions.) |
|
AddVScrollBar(Range, String) | Перегружен. Добавляет новый элемент управления VScrollBar в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddVScrollBar(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления VScrollBar указанного размера. (Определено в ControlExtensions.) |
|
AddWebBrowser(Range, String) | Перегружен. Добавляет новый элемент управления WebBrowser в указанный диапазон листа. (Определено в ControlExtensions.) |
|
AddWebBrowser(Double, Double, Double, Double, String) | Перегружен. Добавляет в заданное расположение на листе новый элемент управления WebBrowser указанного размера. (Определено в ControlExtensions.) |
В начало страницы
Заметки
Используйте методы и свойства интерфейса ControlCollection для управления элементами управления на листе Excel. Для получения дополнительной информации см. Добавление элементов управления в документы Office во время выполнения.
Невозможно создать экземпляр этого интерфейса в коде, поскольку он не имеет открытых конструкторов. Чтобы получить экземпляр этого интерфейса в проекте уровня документа, используйте свойство Controls одного из классов Sheetn в проекте. Чтобы получить экземпляр этого интерфейса в проекте уровня документа, используйте свойство Controls ведущего элемента Worksheet, создаваемого программными средствами во время выполнения. Для получения дополнительной информации см. Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.
В приведенной ниже таблице показано, как использовать члены класса ControlCollection для выполнения общих задач, связанных с элементами управления в документах.
Задача |
Действие |
|---|---|
Добавьте элемент управления в лист. |
Используйте один из методов Add<элемент_управления>. Например, чтобы добавить Microsoft.Office.Tools.Excel.ListObject, воспользуйтесь методом AddListObject. |
Удалите элемент управления из листа. |
Воспользуйтесь методом Remove. |
Определите, присутствует ли элемент управления в коллекции. |
Передайте элемент управления или его имя в качестве параметра метода Contains. |
Получите индекс элемента управления в коллекции. |
Передайте элемент управления или его имя в качестве параметра метода IndexOf. |
Получите элемент управления из коллекции. |
Передайте индекс или имя элемента управления свойству Item. |
Примечание
Данный интерфейс реализуется набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.
Использование
В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформ .NET Framework 4 и .NET Framework 4.5. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.