ControlCollection 인터페이스

아티클
08/10/2011

Visual Studio의 Office 개발 도구를 사용하여 사용자 지정한 Word 문서에 있는 관리되는 컨트롤의 컬렉션을 나타냅니다.

네임스페이스: Microsoft.Office.Tools.Word
어셈블리: Microsoft.Office.Tools.Word(Microsoft.Office.Tools.Word.dll)

구문

‘선언
<GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")> _
Public Interface ControlCollection _
    Inherits IEnumerable

[GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")]
public interface ControlCollection : IEnumerable

ControlCollection 형식에서는 다음과 같은 멤버를 노출합니다.

속성

	이름	설명
	Capacity	ControlCollection 에 포함될 수 있는 컨트롤 수를 가져오거나 설정합니다.
	Count	ControlCollection 의 컨트롤 수를 가져옵니다.
	Item[Int32]	지정된 인덱스에 있는 컨트롤을 가져옵니다.
	Item[Object]	지정된 컨트롤을 가져옵니다.
	Item[String]	지정된 이름의 컨트롤을 가져옵니다.

위쪽

메서드

	이름	설명
	AddBookmark(Bookmark, String)	지정된 기존 Microsoft.Office.Interop.Word.Bookmark의 위치에 있는 문서에 Microsoft.Office.Tools.Word.Bookmark 컨트롤을 추가합니다.
	AddBookmark(Range, String)	새 Bookmark 컨트롤을 문서의 지정된 범위에 추가합니다.
	AddBuildingBlockGalleryContentControl(String)	문서의 현재 선택 영역에 새 BuildingBlockGalleryContentControl을 추가합니다.
	AddBuildingBlockGalleryContentControl(ContentControl, String)	컬렉션에 새 BuildingBlockGalleryContentControl을 추가합니다.새 컨트롤은 문서에 이미 있는 네이티브 콘텐츠 컨트롤을 기반으로 합니다.
	AddBuildingBlockGalleryContentControl(Range, String)	새 BuildingBlockGalleryContentControl 컨트롤을 문서의 지정된 범위에 추가합니다.
	AddComboBoxContentControl(String)	문서의 현재 선택 영역에 새 ComboBoxContentControl을 추가합니다.
	AddComboBoxContentControl(ContentControl, String)	컬렉션에 새 ComboBoxContentControl을 추가합니다.새 컨트롤은 문서에 이미 있는 네이티브 콘텐츠 컨트롤을 기반으로 합니다.
	AddComboBoxContentControl(Range, String)	새 ComboBoxContentControl 컨트롤을 문서의 지정된 범위에 추가합니다.
	AddContentControl(ContentControl, String)	문서의 네이티브 콘텐츠 컨트롤을 기반으로 하는 새 ContentControl을 추가합니다.
	AddContentControl(String, WdContentControlType)	문서의 현재 선택 영역에 지정된 유형의 새 ContentControl을 추가합니다.
	AddContentControl(Range, String, WdContentControlType)	문서의 지정된 범위에 지정된 유형의 새 ContentControl을 추가합니다.
	AddControl(Control, Range, Single, Single, String)	지정된 범위와 크기의 지정된 컨트롤을 ControlCollection에 추가합니다.
	AddControl(Control, Single, Single, Single, Single, String)	지정된 컨트롤을 지정된 크기로 ControlCollection의 지정된 위치에 추가합니다.
	AddDatePickerContentControl(String)	문서의 현재 선택 영역에 새 DatePickerContentControl을 추가합니다.
	AddDatePickerContentControl(ContentControl, String)	컬렉션에 새 DatePickerContentControl을 추가합니다.새 컨트롤은 문서에 이미 있는 네이티브 콘텐츠 컨트롤을 기반으로 합니다.
	AddDatePickerContentControl(Range, String)	새 DatePickerContentControl 컨트롤을 문서의 지정된 범위에 추가합니다.
	AddDropDownListContentControl(String)	문서의 현재 선택 영역에 새 DropDownListContentControl을 추가합니다.
	AddDropDownListContentControl(ContentControl, String)	컬렉션에 새 DropDownListContentControl을 추가합니다.새 컨트롤은 문서에 이미 있는 네이티브 콘텐츠 컨트롤을 기반으로 합니다.
	AddDropDownListContentControl(Range, String)	새 DropDownListContentControl 컨트롤을 문서의 지정된 범위에 추가합니다.
	AddGroupContentControl(String)	문서의 현재 선택 영역에 새 GroupContentControl을 추가합니다.
	AddGroupContentControl(ContentControl, String)	문서의 네이티브 콘텐츠 컨트롤을 기반으로 하는 새 GroupContentControl을 추가합니다.
	AddGroupContentControl(Range, String)	새 GroupContentControl 컨트롤을 문서의 지정된 범위에 추가합니다.
	AddPictureContentControl(String)	문서의 현재 선택 영역에 새 PictureContentControl을 추가합니다.
	AddPictureContentControl(ContentControl, String)	문서의 네이티브 콘텐츠 컨트롤을 기반으로 하는 새 PictureContentControl을 추가합니다.
	AddPictureContentControl(Range, String)	새 PictureContentControl 컨트롤을 문서의 지정된 범위에 추가합니다.
	AddPlainTextContentControl(String)	문서의 현재 선택 영역에 새 PlainTextContentControl을 추가합니다.
	AddPlainTextContentControl(ContentControl, String)	문서의 네이티브 콘텐츠 컨트롤을 기반으로 하는 새 PlainTextContentControl을 추가합니다.
	AddPlainTextContentControl(Range, String)	새 PlainTextContentControl 컨트롤을 문서의 지정된 범위에 추가합니다.
	AddRichTextContentControl(String)	문서의 현재 선택 영역에 새 RichTextContentControl을 추가합니다.
	AddRichTextContentControl(ContentControl, String)	문서의 네이티브 콘텐츠 컨트롤을 기반으로 하는 새 RichTextContentControl을 추가합니다.
	AddRichTextContentControl(Range, String)	새 RichTextContentControl 컨트롤을 문서의 지정된 범위에 추가합니다.
	Contains(Object)	지정된 컨트롤이 ControlCollection 인스턴스의 멤버인지 여부를 확인합니다.
	Contains(String)	지정된 이름의 컨트롤이 ControlCollection 인스턴스의 멤버인지 여부를 확인합니다.
	GetEnumerator	컬렉션을 반복하는 열거자를 반환합니다. (IEnumerable에서 상속됨)
	GetInlineShapeForControl	지정된 컨트롤에 대한 내부 InlineShape을 가져옵니다.
	GetShapeForControl	지정된 컨트롤에 대한 내부 Shape을 가져옵니다.
	IndexOf(Object)	지정된 컨트롤을 검색하고 ControlCollection 인스턴스에서 처음 나타나는 컨트롤의 0부터 시작하는 인덱스를 반환합니다.
	IndexOf(String)	ControlCollection 인스턴스에서 지정된 이름의 컨트롤이 처음 나타나는 곳을 검색합니다.
	Remove(Object)	ControlCollection 인스턴스에서 지정된 컨트롤을 제거합니다.
	Remove(String)	ControlCollection 인스턴스에서 지정된 컨트롤을 제거합니다.
	RemoveAt	ControlCollection 인스턴스에서 지정된 인덱스에 있는 컨트롤을 제거합니다.

위쪽

설명

ControlCollection 메서드 및 속성을 사용하여 Word 문서에서 컨트롤을 관리합니다. 자세한 내용은 런타임에 Office 문서에 컨트롤 추가을 참조하십시오.

문서 수준 프로젝트에서 ControlCollection 개체를 가져오려면 프로젝트에서 ThisDocument 클래스의 Controls 속성을 사용합니다. 응용 프로그램 수준 프로젝트에서 ControlCollection 개체를 가져오려면 런타임에서 프로그래밍 방식으로 만드는 Document 호스트 항목의 Controls 속성을 사용합니다. 자세한 내용은 런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장을 참조하십시오.

다음 표에서는 ControlCollection 멤버를 사용하여 문서의 컨트롤과 관련된 몇 가지 일반적인 작업을 수행하는 방법을 보여 줍니다.

Task	동작
문서에 컨트롤을 추가합니다.	AddControlName 메서드 중 하나를 사용하십시오. 예를 들어, 콘텐츠 컨트롤을 추가하려면 AddContentControl 메서드를 사용하십시오.
문서에서 컨트롤을 제거합니다.	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.