ControlCollection Интерфейс

Определение

Представляет коллекцию управляемых элементов управления на листе Excel в решении Office.Represents a collection of managed controls on an Excel worksheet in an Office solution.

[System.Runtime.InteropServices.Guid("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : System.Collections.IEnumerable
Атрибуты
Реализации

Комментарии

Используйте методы и свойства ControlCollection интерфейса для управления элементами управления на листе Excel.Use the methods and properties of the ControlCollection interface to manage controls on an Excel worksheet. Для получения дополнительной информации см. Adding Controls to Office Documents at Run Time.For more information, see Adding Controls to Office Documents at Run Time.

Нельзя создать экземпляр этого интерфейса в коде, так как у него нет открытых конструкторов.You cannot create an instance of this interface in your code, because it does not have any public constructors. Чтобы получить экземпляр этого интерфейса в проекте уровня документа, используйте Controls свойство одного из Sheet классов n в проекте.To get an instance of this interface in a document-level project, use the Controls property of one of the Sheetn classes in your project. Чтобы получить экземпляр этого интерфейса в проекте уровня документа, используйте Controls свойство Worksheet ведущего элемента, создаваемого программно во время выполнения.To get an instance of this interface in a document-level project, use the Controls property of a Worksheet host item that you create programmatically at run time. Для получения дополнительной информации см. Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.For more information, see Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.

В следующей таблице показано, как использовать ControlCollection элементы для выполнения некоторых распространенных задач, связанных с элементами управления в документах.The following table shows how to use ControlCollection members to perform some common tasks related to controls on documents.

ЗадачаTask ДействиеAction
Добавьте элемент управления на лист.Add a control to the worksheet. Используйте один из методов Add <control> .Use one of the Add*<control>* methods. Например, чтобы добавить Microsoft.Office.Tools.Excel.ListObject , используйте AddListObject метод.For example, to add a Microsoft.Office.Tools.Excel.ListObject, use the AddListObject method.
Удаление элемента управления из листа.Remove a control from the worksheet. Воспользуйтесь методом Remove.Use the Remove method.
Определить, находится ли элемент управления в коллекции.Determine whether a control is in the collection. Передайте элемент управления или его имя в Contains метод.Pass the control or its name to the Contains method.
Возвращает индекс элемента управления в коллекции.Get the index of a control in the collection. Передайте элемент управления или его имя в IndexOf метод.Pass the control or its name to the IndexOf method.
Получение элемента управления из коллекции.Get a control from the collection. Передайте индекс или имя элемента управления в Item[] свойство.Pass the index or name of the control to the Item[] property.

Примечание

Данный интерфейс реализуется набором средств Visual Studio для Office (среда выполнения).This interface is implemented by the Visual Studio Tools for Office runtime. Он не предназначен для реализации в пользовательском коде.It is not intended to be implemented in your code. Дополнительные сведения см. в разделе Visual Studio Tools for Office Runtime Overview.For more information, see Visual Studio Tools for Office Runtime Overview.

ИспользованиеUsage

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4 или более поздних ее версий.This documentation describes the version of this type that is used in Office projects that target the .NET Framework 4 or later. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать.In projects that target the .NET Framework 3.5, this type might have different members and the code examples provided for this type might not work. Документацию об этом типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.For documentation about this type in projects that target the .NET Framework 3.5, see the following reference section in the Visual Studio 2008 documentation: http://go.microsoft.com/fwlink/?LinkId=160658.

Свойства

Count

Получает число элементов управления в объекте ControlCollection.Gets the number of controls in the ControlCollection.

Item[Int32]

Возвращает элемент управления по указанному индексу.Gets the control at the specified index.

Item[String]

Возвращает элемент управления с указанным именем.Gets the control with the specified name.

Методы

AddChart(Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления Chart указанного размера.Adds a new Chart control to the worksheet in the specified size and location.

AddChart(Range, String)

Добавляет новый элемент управления Chart в указанный диапазон листа.Adds a new Chart control to the worksheet at the range specified.

AddControl(Control, Double, Double, Double, Double, String)

Добавляет заданный Control указанного размера в заданное место ControlCollection.Adds the specified Control to the ControlCollection at the location and size specified.

AddControl(Control, Range, String)

Добавляет определенный Control в ControlCollection в определенном диапазоне.Adds the specified Control to the ControlCollection at the specified range.

AddListObject(ListObject)

Добавляет объект ListObject Visual Studio в коллекцию элементов управления, основанную на указанном собственном объекте ListObject.Adds a Visual Studio ListObject to the control collection based on the specified native ListObject.

AddListObject(Range, String)

Добавляет новый элемент управления ListObject в указанный диапазон листа.Adds a new ListObject control to the worksheet at the range specified.

AddNamedRange(Range, String)

Добавляет новый элемент управления NamedRange в указанный диапазон листа.Adds a new NamedRange control to the worksheet at the range specified.

Contains(Object)

Определяет, входит ли указанный элемент управления в экземпляр коллекции ControlCollection.Determines whether the specified control is a member of the ControlCollection instance.

Contains(String)

Определяет, входит ли элемент управления с указанным именем в экземпляр коллекции ControlCollection.Determines whether a control with the specified name is a member of the ControlCollection instance.

IndexOf(Object)

Выполняет поиск указанного элемента управления и возвращает индекс (отсчитываемый с нуля) первого вхождения элемента управления в экземпляре коллекции ControlCollection.Searches for the specified control and returns the zero-based index of the first occurrence in the ControlCollection instance.

IndexOf(String)

Выполняет поиск первого вхождения элемента управления с указанным именем в экземпляре коллекции ControlCollection.Searches for the first occurrence of a control with the specified name in the ControlCollection instance.

Remove(Object)

Удаляет заданный элемент управления из экземпляра ControlCollection.Removes the specified control from the ControlCollection instance.

Remove(String)

Удаляет элемент управления с заданным именем из экземпляра ControlCollection.Removes the control with the specified name from the ControlCollection instance.

RemoveAt(Int32)

Удаляет элемент управления по указанному индексу из экземпляра ControlCollection.Removes the control at the specified index in the ControlCollection instance.

Методы расширения

AddButton(ControlCollection, Range, String)

Добавляет новый элемент управления Button в указанный диапазон листа.Adds a new Button control to the worksheet at the range specified.

AddButton(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления Button указанного размера.Adds a new Button control to the worksheet in the specified size and location.

AddCheckBox(ControlCollection, Range, String)

Добавляет новый элемент управления CheckBox в указанный диапазон листа.Adds a new CheckBox control to the worksheet at the range specified.

AddCheckBox(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления CheckBox указанного размера.Adds a new CheckBox control to the worksheet in the specified size and location.

AddCheckedListBox(ControlCollection, Range, String)

Добавляет новый элемент управления CheckedListBox в указанный диапазон листа.Adds a new CheckedListBox control to the worksheet at the range specified.

AddCheckedListBox(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления CheckedListBox указанного размера.Adds a new CheckedListBox control to the worksheet in the specified size and location.

AddComboBox(ControlCollection, Range, String)

Добавляет новый элемент управления ComboBox в указанный диапазон листа.Adds a new ComboBox control to the worksheet at the range specified.

AddComboBox(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления ComboBox указанного размера.Adds a new ComboBox control to the worksheet in the specified size and location.

AddDataGridView(ControlCollection, Range, String)

Добавляет новый элемент управления DataGridView в указанный диапазон листа.Adds a new DataGridView control to the worksheet at the range specified.

AddDataGridView(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления DataGridView указанного размера.Adds a new DataGridView control to the worksheet in the specified size and location.

AddDateTimePicker(ControlCollection, Range, String)

Добавляет новый элемент управления DateTimePicker в указанный диапазон листа.Adds a new DateTimePicker control to the worksheet at the range specified.

AddDateTimePicker(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления DateTimePicker указанного размера.Adds a new DateTimePicker control to the worksheet in the specified size and location.

AddDomainUpDown(ControlCollection, Range, String)

Добавляет новый элемент управления DomainUpDown в указанный диапазон листа.Adds a new DomainUpDown control to the worksheet at the range specified.

AddDomainUpDown(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления DomainUpDown указанного размера.Adds a new DomainUpDown control to the worksheet in the specified size and location.

AddHScrollBar(ControlCollection, Range, String)

Добавляет новый элемент управления HScrollBar в указанный диапазон листа.Adds a new HScrollBar control to the worksheet at the range specified.

AddHScrollBar(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления HScrollBar указанного размера.Adds a new HScrollBar control to the worksheet in the specified size and location.

AddLabel(ControlCollection, Range, String)

Добавляет новый элемент управления Label в указанный диапазон листа.Adds a new Label control to the worksheet at the range specified.

AddLabel(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления Label указанного размера.Adds a new Label control to the worksheet in the specified size and location.

AddLinkLabel(ControlCollection, Range, String)

Добавляет новый элемент управления LinkLabel в указанный диапазон листа.Adds a new LinkLabel control to the worksheet at the range specified.

AddLinkLabel(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления LinkLabel указанного размера.Adds a new LinkLabel control to the worksheet in the specified size and location.

AddListBox(ControlCollection, Range, String)

Добавляет новый элемент управления ListBox в указанный диапазон листа.Adds a new ListBox control to the worksheet at the range specified.

AddListBox(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления ListBox указанного размера.Adds a new ListBox control to the worksheet in the specified size and location.

AddListView(ControlCollection, Range, String)

Добавляет новый элемент управления ListView в указанный диапазон листа.Adds a new ListView control to the worksheet at the range specified.

AddListView(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления ListView указанного размера.Adds a new ListView control to the worksheet in the specified size and location.

AddMaskedTextBox(ControlCollection, Range, String)

Добавляет новый элемент управления MaskedTextBox в указанный диапазон листа.Adds a new MaskedTextBox control to the worksheet at the range specified.

AddMaskedTextBox(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное расположение документа новый элемент управления MaskedTextBox указанного размера.Adds a new MaskedTextBox control to the document in the specified size and location.

AddMonthCalendar(ControlCollection, Range, String)

Добавляет новый элемент управления MonthCalendar в указанный диапазон листа.Adds a new MonthCalendar control to the worksheet at the range specified.

AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления MonthCalendar указанного размера.Adds a new MonthCalendar control to the worksheet in the specified size and location.

AddNumericUpDown(ControlCollection, Range, String)

Добавляет новый элемент управления NumericUpDown в указанный диапазон листа.Adds a new NumericUpDown control to the worksheet at the range specified.

AddNumericUpDown(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления NumericUpDown указанного размера.Adds a new NumericUpDown control to the worksheet in the specified size and location.

AddPictureBox(ControlCollection, Range, String)

Добавляет новый элемент управления PictureBox в указанный диапазон листа.Adds a new PictureBox control to the worksheet at the range specified.

AddPictureBox(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления PictureBox указанного размера.Adds a new PictureBox control to the worksheet in the specified size and location.

AddProgressBar(ControlCollection, Range, String)

Добавляет новый элемент управления ProgressBar в указанный диапазон листа.Adds a new ProgressBar control to the worksheet at the range specified.

AddProgressBar(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления ProgressBar указанного размера.Adds a new ProgressBar control to the worksheet in the specified size and location.

AddPropertyGrid(ControlCollection, Range, String)

Добавляет новый элемент управления PropertyGrid в указанный диапазон листа.Adds a new PropertyGrid control to the worksheet at the range specified.

AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления PropertyGrid указанного размера.Adds a new PropertyGrid control to the worksheet in the specified size and location.

AddRadioButton(ControlCollection, Range, String)

Добавляет новый элемент управления RadioButton в указанный диапазон листа.Adds a new RadioButton control to the worksheet at the range specified.

AddRadioButton(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления RadioButton указанного размера.Adds a new RadioButton control to the worksheet in the specified size and location.

AddRichTextBox(ControlCollection, Range, String)

Добавляет новый элемент управления RichTextBox в указанный диапазон листа.Adds a new RichTextBox control to the worksheet at the range specified.

AddRichTextBox(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления RichTextBox указанного размера.Adds a new RichTextBox control to the worksheet in the specified size and location.

AddTextBox(ControlCollection, Range, String)

Добавляет новый элемент управления TextBox в указанный диапазон листа.Adds a new TextBox control to the worksheet at the range specified.

AddTextBox(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления TextBox указанного размера.Adds a new TextBox control to the worksheet in the specified size and location.

AddTrackBar(ControlCollection, Range, String)

Добавляет новый элемент управления TrackBar в указанный диапазон листа.Adds a new TrackBar control to the worksheet at the range specified.

AddTrackBar(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления TrackBar указанного размера.Adds a new TrackBar control to the worksheet in the specified size and location.

AddTreeView(ControlCollection, Range, String)

Добавляет новый элемент управления TreeView в указанный диапазон листа.Adds a new TreeView control to the worksheet at the range specified.

AddTreeView(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления TreeView указанного размера.Adds a new TreeView control to the worksheet in the specified size and location.

AddVScrollBar(ControlCollection, Range, String)

Добавляет новый элемент управления VScrollBar в указанный диапазон листа.Adds a new VScrollBar control to the worksheet at the range specified.

AddVScrollBar(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления VScrollBar указанного размера.Adds a new VScrollBar control to the worksheet in the specified size and location.

AddWebBrowser(ControlCollection, Range, String)

Добавляет новый элемент управления WebBrowser в указанный диапазон листа.Adds a new WebBrowser control to the worksheet at the range specified.

AddWebBrowser(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления WebBrowser указанного размера.Adds a new WebBrowser control to the worksheet in the specified size and location.

Применяется к