ControlCollection 인터페이스
Office 솔루션에서 Excel 워크시트의 관리되는 컨트롤 컬렉션을 나타냅니다.
네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)
구문
‘선언
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
Inherits IEnumerable
[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable
ControlCollection 형식에서는 다음과 같은 멤버를 노출합니다.
속성
| 이름 | 설명 | |
|---|---|---|
.gif "Public 속성") |
Count | ControlCollection 의 컨트롤 수를 가져옵니다. |
|
Item[Int32] | 지정된 인덱스 위치의 컨트롤을 가져옵니다. |
|
Item[String] | 지정된 이름의 컨트롤을 가져옵니다. |
위쪽
메서드
| 이름 | 설명 | |
|---|---|---|
.gif "Public 메서드") |
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.Interop.Excel.ListObject를 기반으로 하는 컨트롤 컬렉션에 Visual Studio Microsoft.Office.Tools.Excel.ListObject를 추가합니다. |
|
AddListObject(Range, String) | 워크시트의 지정된 범위에 새 ListObject 컨트롤을 추가합니다. |
|
AddNamedRange | 워크시트의 지정된 범위에 새 NamedRange 컨트롤을 추가합니다. |
|
Contains(Object) | 지정된 컨트롤이 ControlCollection 인스턴스의 멤버인지 여부를 확인합니다. |
|
Contains(String) | 지정된 이름의 컨트롤이 ControlCollection 인스턴스의 멤버인지 여부를 확인합니다. |
|
GetEnumerator | 컬렉션을 반복하는 열거자를 반환합니다. (IEnumerable에서 상속됨) |
|
IndexOf(Object) | 지정된 컨트롤을 검색하고 ControlCollection 인스턴스에서 처음 나타나는 컨트롤의 인덱스(0부터 시작)를 반환합니다. |
|
IndexOf(String) | ControlCollection 인스턴스에서 처음 나타나는 지정된 이름의 컨트롤을 검색합니다. |
|
Remove(Object) | ControlCollection 인스턴스에서 지정된 컨트롤을 제거합니다. |
|
Remove(String) | ControlCollection 인스턴스에서 지정된 이름의 컨트롤을 제거합니다. |
|
RemoveAt | ControlCollection 인스턴스의 지정된 인덱스에서 컨트롤을 제거합니다. |
위쪽
설명
ControlCollection 인터페이스의 메서드와 속성을 사용하여 Excel 워크시트에서 컨트롤을 관리합니다. 자세한 내용은 런타임에 Office 문서에 컨트롤 추가을 참조하십시오.
공용 생성자가 없으므로 코드에서 이 인터페이스의 인스턴스를 만들 수 없습니다. 문서 수준 프로젝트에서 이 인터페이스의 인스턴스를 가져오려면 프로젝트에서 Sheetn 클래스 중 하나의 Controls 속성을 사용합니다. 문서 수준 프로젝트에서 이 인터페이스의 인스턴스를 가져오려면 런타임에 프로그래밍 방식으로 만드는 Worksheet 호스트 항목의 Controls 속성을 사용합니다. 자세한 내용은 런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장을 참조하십시오.
다음 표에서는 ControlCollection 멤버를 사용하여 문서의 컨트롤과 관련된 몇 가지 일반적인 작업을 수행하는 방법을 보여 줍니다.
Task |
동작 |
|---|---|
워크시트에 컨트롤을 추가합니다. |
Add<control> 메서드 중 하나를 사용하십시오. 예를 들어, Microsoft.Office.Tools.Excel.ListObject를 추가하려면 AddListObject 메서드를 사용합니다. |
워크시트에서 컨트롤을 제거합니다. |
Remove 메서드를 사용하십시오. |
컨트롤이 컬렉션에 있는지 여부를 확인합니다. |
컨트롤 또는 해당 이름을 Contains 메서드에 전달 |
컬렉션에서 컨트롤의 인덱스를 가져옵니다. |
컨트롤 또는 해당 이름을 IndexOf 메서드에 전달 |
컬렉션에서 컨트롤을 가져옵니다. |
컨트롤의 인덱스 또는 이름을 Item 속성에 전달합니다. |
참고
이 인터페이스는 Visual Studio Tools for Office Runtime에 의해 구현되며 코드에서 직접 구현할 수는 없습니다. 자세한 내용은 Visual Studio Tools for Office 런타임 개요를 참조하십시오.
용도
이 문서에서는 .NET Framework 4를 대상으로 하는 Office 프로젝트에서 사용되는 이 형식의 버전을 설명합니다. .NET Framework 3.5를 대상으로 하는 프로젝트에서는 이 형식의 멤버가 다를 수 있으며 이 형식을 위해 제공되는 코드 예제가 작동하지 않을 수도 있습니다. .NET Framework 3.5를 대상으로 하는 프로젝트의 이 형식에 대한 문서는 Visual Studio 2008 설명서의 다음 참조 섹션을 참조하십시오. https://go.microsoft.com/fwlink/?LinkId=160658.