DocumentBase.SelectContentControlsByTitle (Método)
Devuelve todos los controles de contenido del documento que tiene el título especificado.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word.v4.0.Utilities (en Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Sintaxis
'Declaración
Public Function SelectContentControlsByTitle ( _
title As String _
) As ContentControls
public ContentControls SelectContentControlsByTitle(
string title
)
Parámetros
- title
Tipo: System.String
Título de los controles de contenido que se va a devolver.
Valor devuelto
Tipo: Microsoft.Office.Interop.Word.ContentControls
Colección ContentControls que incluye los controles de contenido que tienen el título especificado.
Ejemplos
En el ejemplo de código siguiente se agregan dos párrafos al documento y, a continuación, se agrega un control a cada nuevo párrafo: RichTextContentControl y ComboBoxContentControl. En el ejemplo se establecen las propiedades Title y Tag de cada control. Luego, se llama al método SelectContentControlsByTitle para obtener la colección de controles de contenido nativos cuyo título es igual a Customer Title. A continuación, se modifica el texto del marcador de posición de cada control de la colección devuelta, que, en este caso, contiene ComboBoxContentControl únicamente. Para usar este ejemplo, ejecútelo desde la clase ThisDocument en un proyecto de nivel de documento.
Private Sub ContentControlsTitle()
Dim par1 As Word.Paragraph = Me.Paragraphs.Add()
Dim richTextControl As Microsoft.Office.Tools.Word.RichTextContentControl _
= Me.Controls.AddRichTextContentControl(par1.Range, "richTextControl")
richTextControl.Tag = "Customer"
richTextControl.Title = "Customer Name"
Dim par2 As Word.Paragraph = Me.Paragraphs.Add()
Dim comboBoxControl As Microsoft.Office.Tools.Word.ComboBoxContentControl _
= Me.Controls.AddComboBoxContentControl(par2.Range, "comboBoxControl")
comboBoxControl.Tag = "Customer"
comboBoxControl.Title = "Customer Title"
Dim myControls As Word.ContentControls = _
Me.SelectContentControlsByTitle("Customer Title")
For Each ctrl As Word.ContentControl In myControls
ctrl.SetPlaceholderText(Text:="Select a title.")
Next
End Sub
private void ContentControlsTitle()
{
Word.Paragraph par1 = this.Paragraphs.Add(ref missing);
Microsoft.Office.Tools.Word.RichTextContentControl richTextControl =
this.Controls.AddRichTextContentControl(par1.Range,
"richTextControl");
richTextControl.Tag = "Customer";
richTextControl.Title = "Customer Name";
Word.Paragraph par2 = this.Paragraphs.Add(ref missing);
Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl =
this.Controls.AddComboBoxContentControl(par2.Range,
"comboBoxControl");
comboBoxControl.Tag = "Customer";
comboBoxControl.Title = "Customer Title";
Word.ContentControls myControls =
this.SelectContentControlsByTitle("Customer Title");
foreach (Word.ContentControl ctrl in myControls)
{
ctrl.SetPlaceholderText(null, null, "Select a title.");
}
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.