ContentControl 인터페이스

아티클
08/10/2011

문서의 콘텐츠 컨트롤을 나타냅니다.

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

구문

‘선언
<GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")> _
Public Interface ContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")]
public interface ContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

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

속성

	이름	설명
	Application	Microsoft Office Word의 현재 인스턴스를 나타내는 Microsoft.Office.Interop.Word.Application을 가져옵니다.
	BindingContext	IBindableComponent 에 대한 현재 위치 관리자의 컬렉션을 가져오거나 설정합니다. (IBindableComponent에서 상속됨)
	BuildingBlockCategory	빌딩 블록 갤러리를 나타내는 ContentControl에 표시되는 빌딩 블록의 범주를 가져오거나 설정합니다.
	BuildingBlockType	빌딩 블록 갤러리를 나타내는 ContentControl에 표시되는 빌딩 블록의 형식을 가져오거나 설정합니다.
	Checked	확인란 컨트롤인 ContentControl이 선택되어 있거나 선택되어 있지 않은지 여부를 나타내는 값을 가져오거나 설정합니다.이 속성은 Word 2010 프로젝트에만 사용할 수 있습니다.
	Container	인프라입니다. (ContentControlBase에서 상속됨)
	ContainerComponent	인프라입니다. (ContentControlBase에서 상속됨)
	Creator	ContentControl 이 만들어진 응용 프로그램을 나타내는 32비트 정수를 가져옵니다.
	DataBindings	이 IBindableComponent에 대한 데이터 바인딩 개체의 컬렉션을 가져옵니다. (IBindableComponent에서 상속됨)
	DateCalendarType	날짜 선택기를 나타내는 ContentControl에 표시되는 달력 형식을 가져오거나 설정합니다.
	DateDisplayFormat	날짜 선택기를 나타내는 ContentControl에 표시되는 날짜 형식을 지정하는 문자열을 가져오거나 설정합니다.
	DateDisplayLocale	날짜 선택기를 나타내는 ContentControl에 표시되는 날짜의 언어 형식을 가져오거나 설정합니다.
	DateStorageFormat	날짜 선택기를 나타내는 ContentControl에서 사용자 지정 XML 부분에 날짜를 저장하는 형식을 가져오거나 설정합니다.
	DefaultDataSourceUpdateMode	ContentControlBase 에 대한 기본 DataSourceUpdateMode를 가져오거나 설정합니다. (ContentControlBase에서 상속됨)
	DefaultTextStyle	ContentControl 의 텍스트 서식을 지정하는 데 사용되는 문자 스타일 이름을 가져옵니다.
	DropDownListEntries	드롭다운 목록 또는 콤보 상자를 나타내는 ContentControl이 표시하는 항목의 컬렉션을 가져옵니다.
	ID	콘텐츠 컨트롤을 식별하는 고유 번호를 가져옵니다. (ContentControlBase에서 상속됨)
	InnerObject	Microsoft.Office.Tools.Word.ContentControlBase 에 대한 내부 Microsoft.Office.Interop.Word.ContentControl 개체를 가져옵니다. (ContentControlBase에서 상속됨)
	LockContentControl	문서에서 ContentControl을 삭제할 수 있는지 여부를 지정하는 값을 가져오거나 설정합니다.
	LockContents	ContentControl 의 내용을 편집할 수 있는지 여부를 지정하는 값을 가져오거나 설정합니다.
	MultiLine	ContentControl 에 줄 바꿈을 포함할 수 있는지 여부를 지정하는 값을 가져오거나 설정합니다.
	Parent	ContentControl 의 부모를 가져옵니다.
	ParentContentControl	다른 콘텐츠 컨트롤에 중첩된 ContentControl의 부모 콘텐츠 컨트롤을 가져옵니다.
	PlaceholderText	사용자 작업이나 다른 일부 작업으로 인해 텍스트가 변경될 때까지 ContentControl에 표시되는 텍스트를 가져옵니다.
	Range	ContentControl 의 콘텐츠를 나타내는 Range를 가져옵니다.
	ShowingPlaceholderText	ContentControl 에서 현재 개체 틀 텍스트를 표시하고 있는지 여부를 지정하는 값을 가져옵니다.
	Site	IComponent 와 관련된 ISite를 가져오거나 설정합니다 . (IComponent에서 상속됨)
	Tag	ContentControl 과 연결할 문자열을 가져오거나 설정합니다.
	Temporary	컨트롤을 편집할 때 ContentControl이 문서에서 자동으로 삭제되는지 여부를 지정하는 값을 가져오거나 설정합니다.
	Title	ContentControl 의 제목을 가져오거나 설정합니다.
	Type	ContentControl 이 나타내는 콘텐츠 컨트롤의 형식을 지정하는 값을 가져오거나 설정합니다.
	XMLMapping	ContentControl 과 사용자 지정 XML 부분의 요소 간 바인딩을 나타내는 XMLMapping을 가져옵니다.

위쪽

메서드

	이름	설명
	BeginInit	초기화가 시작됨을 개체에 알립니다. (ISupportInitialize에서 상속됨)
	Copy	문서의 ContentControl을 클립보드에 복사합니다.
	Cut	ContentControl 을 문서에서 제거하고 클립보드에 추가합니다.
	Delete	동적으로 만든 콘텐츠 컨트롤을 문서에서 삭제하고 문서의 ControlCollection에서도 제거합니다. (ContentControlBase에서 상속됨)
	Dispose	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 응용 프로그램 정의 작업을 수행합니다. (IDisposable에서 상속됨)
	EndInit	초기화가 완료됨을 개체에 알립니다. (ISupportInitialize에서 상속됨)
	SetCheckedSymbol	확인란 컨트롤인 ContentControl의 선택된 상태를 나타내는 데 사용되는 기호를 설정합니다.이 메서드는 Word 2010 프로젝트에만 사용할 수 있습니다.
	SetPlaceholderText	BuildingBlock , Range 또는 문자열에 있는 텍스트를 ContentControl에 개체 틀 텍스트로 표시합니다.
	SetUncheckedSymbol	확인란 컨트롤인 ContentControl의 선택되지 않은 상태를 나타내는 데 사용되는 기호를 설정합니다.이 메서드는 Word 2010 프로젝트에만 사용할 수 있습니다.
	Ungroup	ContentControl 이 들어 있는 그룹 콘텐츠 컨트롤을 문서에서 제거하여 해당 영역이 더 이상 보호되지 않도록 합니다.

위쪽

이벤트

	이름	설명
	Added	콘텐츠 컨트롤이 문서에 추가된 후에 발생합니다. (ContentControlBase에서 상속됨)
	BindingContextChanged	ContentControlBase 의 BindingContext 속성 값이 변경될 때 발생합니다. (ContentControlBase에서 상속됨)
	ContentUpdating	콘텐츠 컨트롤이 사용자 지정 XML 부분에 바인딩된 경우 Microsoft Office Word에서 콘텐츠 컨트롤의 텍스트를 업데이트하기 직전에 발생합니다. (ContentControlBase에서 상속됨)
	Deleting	콘텐츠 컨트롤이 문서에서 삭제되기 직전에 발생합니다. (ContentControlBase에서 상속됨)
	Disposed	구성 요소의 Disposed 이벤트를 처리하는 메서드를 나타냅니다. (IComponent에서 상속됨)
	Entering	사용자가 콘텐츠 컨트롤의 안쪽을 클릭하거나 프로그래밍 방식으로 커서가 콘텐츠 컨트롤의 안쪽에 놓이면 발생합니다. (ContentControlBase에서 상속됨)
	Exiting	사용자가 콘텐츠 컨트롤의 바깥쪽을 클릭하거나 프로그래밍 방식으로 커서가 콘텐츠 컨트롤의 바깥쪽에 놓이면 발생합니다. (ContentControlBase에서 상속됨)
	StoreUpdating	Microsoft Office Word에서 콘텐츠 컨트롤에 바인딩된 사용자 지정 XML 부분의 데이터를 업데이트하기 직전, 즉 콘텐츠 컨트롤의 텍스트가 변경된 후에 발생합니다. (ContentControlBase에서 상속됨)
	Validated	콘텐츠 컨트롤의 유효성 검사가 성공적으로 완료되었을 때 발생합니다. (ContentControlBase에서 상속됨)
	Validating	콘텐츠 컨트롤의 내용에 대해 유효성을 검사할 때 발생합니다. (ContentControlBase에서 상속됨)

위쪽

설명

ContentControl 개체는 Microsoft Office Word에서 사용할 수 있는 8가지 형식의 콘텐츠 컨트롤을 나타낼 수 있는 변경 가능한 컨트롤입니다. 예를 들어 처음에 일반 텍스트 컨트롤의 기능을 하는 ContentControl을 만들 경우 런타임에 이를 변경하여 콤보 상자처럼 동작하게 만들 수 있습니다. 이 방법으로 다른 콘텐츠 컨트롤은 사용할 수 없습니다. 예를 들어 RichTextContentControl은 서식 있는 텍스트 컨트롤만 나타낼 수 있습니다. 콘텐츠 컨트롤에 대한 자세한 내용은 콘텐츠 컨트롤을 참조하십시오.

ContentControl을 만들려면 AddContentControl 메서드 중 하나를 사용합니다. 디자인 타임에 ContentControl을 문서에 추가할 수는 없습니다.

ContentControl을 만들 때는 만들려는 콘텐츠 컨트롤의 형식을 지정하거나 기존 콘텐츠 컨트롤을 기반으로 새 컨트롤을 만들어야 합니다. ContentControl을 만든 후 Type 속성을 사용하여 해당 클래스가 나타내는 콘텐츠 컨트롤의 형식을 변경할 수 있습니다.

ContentControl의 일부 멤버는 컨트롤이 해당 멤버를 사용하도록 되어 있지 않은 형식으로 설정되어 있을 때 해당 멤버를 사용하면 예외를 throw합니다. 예를 들어 날짜 선택을 나타내지 않는 ContentControl에서 DateCalendarType 속성을 사용하려고 하면 해당 속성에서 예외를 throw합니다.

참고

이 인터페이스는 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.