Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método ControlCollection.AddDropDownListContentControl (String)

 

Publicado: octubre de 2016

Agrega un nuevo objeto DropDownListContentControl en la selección actual del documento.

Espacio de nombres:   Microsoft.Office.Tools.Word
Ensamblado:  Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)

DropDownListContentControl AddDropDownListContentControl(
	string name
)

Parámetros

name
Type: System.String

El nombre del nuevo control.

Valor devuelto

Type: Microsoft.Office.Tools.Word.DropDownListContentControl

El objeto DropDownListContentControl que se agregó al documento.

Exception Condition
ArgumentNullException

name es null o tiene una longitud cero.

ControlNameAlreadyExistsException

Un control con el mismo nombre ya se encuentra en el objeto ControlCollection.

Use this method to add a new T:Microsoft.Office.Tools.Word.DropDownListContentControl at the current selection in the document at run time. For more information, see Adding Controls to Office Documents at Run Time.

The following code example adds a new T:Microsoft.Office.Tools.Word.DropDownListContentControl to the beginning of the document. The example also adds the names of several days to the list of items that users can select in the control.

This version is for a document-level customization. To use this code, paste it into the ThisDocument class in your project, and call the AddDropDownListControlAtSelection method from the ThisDocument_Startup method.

private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl1;

private void AddDropDownListControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    dropDownListControl1 = this.Controls.AddDropDownListContentControl("dropDownListControl1");
    dropDownListControl1.DropDownListEntries.Add("Monday", "Monday", 0);
    dropDownListControl1.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
    dropDownListControl1.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
    dropDownListControl1.PlaceholderText = "Choose a day";
}

This version is for an application-level add-in that targets the net_v40_short or the net_v45. To use this code, paste it into the ThisAddIn class in your project, and call the AddDropDownListControlAtSelection method from the ThisAddIn_Startup method.

private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl1;

private void AddDropDownListControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    dropDownListControl1 = vstoDoc.Controls.AddDropDownListContentControl("dropDownListControl1");
    dropDownListControl1.DropDownListEntries.Add("Monday", "Monday", 0);
    dropDownListControl1.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
    dropDownListControl1.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
    dropDownListControl1.PlaceholderText = "Choose a day";
}
Volver al principio
Mostrar: