ComboBoxContentControl 인터페이스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
문서의 콤보 상자를 나타냅니다.
public interface class ComboBoxContentControl : IDisposable, Microsoft::Office::Tools::Word::ContentControlBase, System::ComponentModel::IComponent, System::ComponentModel::ISupportInitialize, System::Windows::Forms::IBindableComponent[System.Runtime.InteropServices.Guid("fff2d316-e224-4cd9-a10c-3edf95689a6d")]
public interface ComboBoxContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent[<System.Runtime.InteropServices.Guid("fff2d316-e224-4cd9-a10c-3edf95689a6d")>]
type ComboBoxContentControl = interface
interface ContentControlBase
interface IBindableComponent
interface IComponent
interface IDisposable
interface ISupportInitializePublic Interface ComboBoxContentControl
Implements ContentControlBase, IBindableComponent, IComponent, IDisposable, ISupportInitialize- 특성
- 구현
예제
다음 코드 예제에서는 문서의 시작 부분에 새 ComboBoxContentControl 를 추가합니다. 사용자는 컨트롤에 표시되는 색 이름을 선택하거나 새 색의 이름을 입력할 수 있습니다.
이 버전은 문서 수준 사용자 지정을 위한 것입니다. 이 코드를 사용하려면 프로젝트의 클래스에 ThisDocument 붙여넣고 메서드에서 메서드를 AddComboBoxControlAtSelectionThisDocument_Startup 호출합니다.
private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;
private void AddComboBoxControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
comboBoxControl1 = this.Controls.AddComboBoxContentControl("comboBoxControl1");
comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}
Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl
Private Sub AddComboBoxControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
comboBoxControl1 = Me.Controls.AddComboBoxContentControl("comboBoxControl1")
With comboBoxControl1
.DropDownListEntries.Add("Red", "Red", 0)
.DropDownListEntries.Add("Green", "Green", 1)
.DropDownListEntries.Add("Blue", "Blue", 2)
.PlaceholderText = "Choose a color, or enter your own"
End With
End Sub
이 버전은 애플리케이션 수준 추가 기능용입니다. 이 코드를 사용하려면 프로젝트의 클래스에 ThisAddIn 붙여넣고 메서드에서 메서드를 AddComboBoxControlAtSelectionThisAddIn_Startup 호출합니다.
private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;
private void AddComboBoxControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl(
"comboBoxControl1");
comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}
Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl
Private Sub AddComboBoxControlAtSelection()
If Me.Application.ActiveDocument Is Nothing Then
Return
End If
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
vstoDoc.Paragraphs(1).Range.Select()
comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl("comboBoxControl1")
With comboBoxControl1
.DropDownListEntries.Add("Red", "Red", 0)
.DropDownListEntries.Add("Green", "Green", 1)
.DropDownListEntries.Add("Blue", "Blue", 2)
.PlaceholderText = "Choose a color, or enter your own"
End With
End Sub
설명
는 ComboBoxContentControl 사용자가 선택할 수 있는 항목 목록을 표시합니다. 사용자는 에 ComboBoxContentControl자신의 텍스트를 입력할 수도 있습니다.
사용자가 편집할 수 없는 항목의 드롭다운 목록을 텍스트 상자에 표시하려면 를 DropDownListContentControl사용합니다.
의 항목 ComboBoxContentControl목록에 액세스하려면 속성을 사용합니다 DropDownListEntries .
참고
이 인터페이스는 Visual Studio Tools for Office Runtime에 의해 구현되며 코드에서 직접 구현할 수는 없습니다. 자세한 내용은 Visual Studio Tools for Office 런타임 개요를 참조하세요.
콘텐츠 컨트롤
는 ComboBoxContentControl Microsoft Office Word 문서 및 템플릿을 디자인하는 데 사용할 수 있는 8가지 유형의 콘텐츠 컨트롤 중 하나입니다. 콘텐츠 컨트롤에는 양식과 같은 입력을 제어하는 UI(사용자 인터페이스)가 있습니다. 콘텐츠 컨트롤을 사용하여 사용자가 문서 또는 서식 파일의 보호된 섹션을 편집하지 못하도록 하고 콘텐츠 컨트롤을 데이터 원본에 바인딩할 수도 있습니다. 자세한 내용은 콘텐츠 컨트롤을 참조하세요.
사용량
이 설명서에서는 .NET Framework 4 이상을 대상으로 하는 Office 프로젝트에서 사용되는 이 형식의 버전에 대해 설명합니다. .NET Framework 3.5를 대상으로 하는 프로젝트에서는 이 형식의 멤버가 다를 수 있으며 이 형식을 위해 제공되는 코드 예제가 작동하지 않을 수도 있습니다. .NET Framework 3.5를 대상으로 하는 프로젝트의 이 형식에 대한 문서는 Visual Studio 2008 설명서의 참조 섹션(http://go.microsoft.com/fwlink/?LinkId=160658)을 참조하세요.
속성
메서드
| Copy() |
문서의 ComboBoxContentControl을 클립보드에 복사합니다. |
| Cut() |
ComboBoxContentControl을 문서에서 제거하고 클립보드에 추가합니다. |
| Delete(Boolean) |
문서에서 동적으로 생성된 콘텐츠 컨트롤을 삭제하고 문서의 ControlCollection에서 제거합니다. (다음에서 상속됨 ContentControlBase) |
| SetPlaceholderText(BuildingBlock, Range, String) |
T:Microsoft.Office.Interop에 있는 텍스트를 표시합니다. Word. BuildingBlock, 또는 문자열을 Range의 자리 표시자 텍스트로 사용합니다ComboBoxContentControl. |
이벤트
| Added |
콘텐츠 컨트롤이 문서에 추가된 후에 발생합니다. (다음에서 상속됨 ContentControlBase) |
| BindingContextChanged |
BindingContext의 ContentControlBase 속성 값이 변경될 때 발생합니다. (다음에서 상속됨 ContentControlBase) |
| ContentUpdating |
콘텐츠 컨트롤이 사용자 지정 XML 부분에 바인딩된 경우 Microsoft Office Word에서 콘텐츠 컨트롤의 텍스트를 업데이트하기 직전에 발생합니다. (다음에서 상속됨 ContentControlBase) |
| Deleting |
콘텐츠 컨트롤이 문서에서 삭제되기 직전에 발생합니다. (다음에서 상속됨 ContentControlBase) |
| Entering |
사용자가 콘텐츠 컨트롤의 안쪽을 클릭하거나 프로그래밍 방식으로 커서가 콘텐츠 컨트롤의 안쪽에 놓이면 발생합니다. (다음에서 상속됨 ContentControlBase) |
| Exiting |
사용자가 콘텐츠 컨트롤의 바깥쪽을 클릭하거나 프로그래밍 방식으로 커서가 콘텐츠 컨트롤의 바깥쪽에 놓이면 발생합니다. (다음에서 상속됨 ContentControlBase) |
| StoreUpdating |
Microsoft Office Word에서 콘텐츠 컨트롤에 바인딩된 사용자 지정 XML 부분의 데이터를 업데이트하기 직전(즉, 콘텐츠 컨트롤의 텍스트가 변경된 후)에 발생합니다. (다음에서 상속됨 ContentControlBase) |
| Validated |
콘텐츠 컨트롤의 유효성 검사가 성공적으로 완료되었을 때 발생합니다. (다음에서 상속됨 ContentControlBase) |
| Validating |
콘텐츠 컨트롤의 내용에 대해 유효성을 검사할 때 발생합니다. (다음에서 상속됨 ContentControlBase) |