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项目中的 类中，然后从 ThisDocument_Startup 方法调用 AddComboBoxControlAtSelection 方法。
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项目中的 类中，然后从 ThisAddIn_Startup 方法调用 AddComboBoxControlAtSelection 方法。
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 Runtime Overview。
内容控件
ComboBoxContentControl是可用于在 Microsoft Office Word中设计文档和模板的八种内容控件之一。 内容控件具有用户界面 (UI) ，该用户界面具有控制输入（如窗体）。 可以使用内容控件来阻止用户编辑文档或模板的受保护部分，还可以将内容控件绑定到数据源。 有关更多信息，请参见 Content Controls。
使用情况
本文档介绍面向 .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) |