ComboBoxContentControl Interfaz

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Word

Ensamblado:: Microsoft.Office.Tools.Word.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Representa un cuadro combinado de un documento.

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 ISupportInitialize

Public Interface ComboBoxContentControl
Implements ContentControlBase, IBindableComponent, IComponent, IDisposable, ISupportInitialize

Atributos: GuidAttribute

Implementaciones: ContentControlBase IComponent ISupportInitialize IDisposable IBindableComponent

Ejemplos

En el ejemplo de código siguiente se agrega un nuevo ComboBoxContentControl al principio del documento. Los usuarios pueden seleccionar un nombre de color mostrado por el control o pueden escribir el nombre de un nuevo color.

Esta versión es para una personalización de nivel de documento. Para usar este código, péguelo en la ThisDocument clase del proyecto y llame al AddComboBoxControlAtSelection método desde el ThisDocument_Startup método .

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

Esta versión es para un complemento de nivel de aplicación. Para usar este código, péguelo en la ThisAddIn clase del proyecto y llame al AddComboBoxControlAtSelection método desde el ThisAddIn_Startup método .

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

Comentarios

Muestra ComboBoxContentControl una lista de elementos que los usuarios pueden seleccionar. Los usuarios también pueden escribir su propio texto en .ComboBoxContentControl

Para mostrar una lista desplegable de elementos en un cuadro de texto que los usuarios no pueden editar, use .DropDownListContentControl

Para tener acceso a la lista de elementos de , ComboBoxContentControluse la DropDownListEntries propiedad .

Nota

Esta interfaz está implementada por el Runtime de Microsoft Visual Studio Tools para Office No está prevista su implementación en el código. Para obtener más información, consulta Visual Studio Tools for Office Runtime Overview.

Controles de contenido

ComboBoxContentControl Es uno de los ocho tipos de controles de contenido que puede usar para diseñar documentos y plantillas en Microsoft Office Word. Los controles de contenido tienen una interfaz de usuario (UI) que tiene entradas controladas como un formulario. Puede usar controles de contenido para evitar que los usuarios editan secciones protegidas del documento o plantilla, y también puede enlazar controles de contenido a un origen de datos. Para obtener más información, consulta Content Controls.

Uso

En esta documentación se describe la versión de este tipo que se usa en los proyectos de Office destinados a .NET Framework 4 o una versión posterior. En los proyectos destinados a .NET Framework 3.5, este tipo podría tener unos miembros diferentes y los ejemplos de código de este tipo podrían no funcionar. Para informarse sobre este tipo en los proyectos destinados a .NET Framework 3.5, consulte la siguiente sección de referencia en la documentación de Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Propiedades

Application	Obtiene un objeto Application que representa la instancia actual de Microsoft Office Word.
Container	Representa un cuadro combinado de un documento. (Heredado de ContentControlBase)
ContainerComponent	Representa un cuadro combinado de un documento. (Heredado de ContentControlBase)
Creator	Obtiene un entero de 32 bits que indica la aplicación en que se creó el control ComboBoxContentControl.
DefaultDataSourceUpdateMode	Obtiene o establece el objeto DataSourceUpdateMode predeterminado de ContentControlBase. (Heredado de ContentControlBase)
DefaultTextStyle	Obtiene el nombre del estilo de carácter que se utiliza para dar formato al texto de ComboBoxContentControl.
DropDownListEntries	Obtiene la colección de elementos que se muestran en ComboBoxContentControl.
ID	Obtiene un número único que identifica el control de contenido. (Heredado de ContentControlBase)
InnerObject	Obtiene el objeto ContentControl subyacente para ContentControlBase. (Heredado de ContentControlBase)
LockContentControl	Obtiene o establece un valor que especifica si el objeto ComboBoxContentControl puede eliminarse del documento.
LockContents	Obtiene o establece un valor que especifica si el contenido del objeto ComboBoxContentControl puede editarse.
MultiLine	Obtiene o establece un valor que especifica si ComboBoxContentControl puede contener saltos de línea.
Parent	Obtiene el objeto principal de ComboBoxContentControl.
ParentContentControl	Obtiene el control de contenido primario de un objeto ComboBoxContentControl que está anidado en otro control de contenido.
PlaceholderText	Obtiene o establece el texto que se muestra en ComboBoxContentControl hasta que este texto se modifica mediante una acción del usuario o alguna otra operación.
Range	Obtiene un objeto Range que representa el contenido de ComboBoxContentControl.
ShowingPlaceholderText	Obtiene un valor que indica si ComboBoxContentControl está mostrando actualmente el texto del marcador de posición.
Tag	Obtiene o establece una cadena que se va a asociar al control ComboBoxContentControl.
Temporary	Obtiene o establece un valor que especifica si ComboBoxContentControl se elimina automáticamente del documento cuando se edita el control.
Text	Obtiene o establece el texto de ComboBoxContentControl.
Title	Obtiene o establece el título de ComboBoxContentControl.
XMLMapping	Obtiene un objeto XMLMapping que representa el enlace entre el objeto ComboBoxContentControl y un elemento de un elemento XML personalizado.

Métodos

Copy()	Copia el control ComboBoxContentControl del documento en el Portapapeles.
Cut()	Quita el control ComboBoxContentControl del documento y lo agrega al Portapapeles.
Delete(Boolean)	Elimina del documento un control de contenido creado dinámicamente y lo quita del objeto ControlCollection en el documento. (Heredado de ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)	Muestra el texto que se encuentra en T:Microsoft.Office.Interop. Word. BuildingBlock, , Rangeo una cadena como texto de marcador de posición en .ComboBoxContentControl

Eventos

Added	Se produce una vez que se ha agregado el control de contenido al documento. (Heredado de ContentControlBase)
BindingContextChanged	Se produce cuando cambia el valor de la propiedad BindingContext de la clase ContentControlBase. (Heredado de ContentControlBase)
ContentUpdating	Se produce inmediatamente antes de que Microsoft Office Word actualice el texto del control de contenido, si el control de contenido está enlazado a un elemento XML personalizado. (Heredado de ContentControlBase)
Deleting	Se produce inmediatamente antes de que se elimine el control de contenido del documento. (Heredado de ContentControlBase)
Entering	Se produce cuando el usuario hace clic en el control de contenido o cuando el cursor se mueve dentro del control de contenido mediante programación. (Heredado de ContentControlBase)
Exiting	Se produce cuando el usuario hace clic fuera del control de contenido o cuando el cursor se mueve fuera del control de contenido mediante programación. (Heredado de ContentControlBase)
StoreUpdating	Se produce inmediatamente antes de que Microsoft Office Word actualice los datos de un elemento XML personalizado que está enlazado al control de contenido (es decir, después de modificar el texto en el control de contenido). (Heredado de ContentControlBase)
Validated	Se produce cuando el control de contenido se ha validado correctamente. (Heredado de ContentControlBase)
Validating	Se produce cuando se valida el contenido del control de contenido. (Heredado de ContentControlBase)

Se aplica a

Compartir a través de