DocumentBase.SelectContentControlsByTitle - метод

Статья
08/11/2011

Возвращает все элементы управления содержимым в документе с указанным заголовком.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v4.0.Utilities (в Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Синтаксис

'Декларация
Public Function SelectContentControlsByTitle ( _
    title As String _
) As ContentControls

public ContentControls SelectContentControlsByTitle(
    string title
)

Параметры

title
Тип: System.String
Заголовок возвращаемых элементов управления содержимым.

Возвращаемое значение

Тип: Microsoft.Office.Interop.Word.ContentControls
Коллекция ContentControls, в которой хранятся все элементы управления содержимым с указанным заголовком.

Примеры

В приведенном ниже примере кода в документ добавляются два абзаца, после чего в каждый из этих абзацев добавляется по одному элементу управления: RichTextContentControl и ComboBoxContentControl. В этом примере присваивается значение свойствам Tag и Title каждого элемента управления. Далее в коде вызывается метод SelectContentControlsByTitle, возвращающий коллекцию исходных элементов управления содержимым с заголовком Customer Title. Затем в коде для каждого элемента управления в возвращенной коллекции изменяется замещающий текст; в данном случае коллекция содержит только элемент управления ComboBoxContentControl. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.

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.");                
    }
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

DocumentBase Класс

Microsoft.Office.Tools.Word - пространство имен

Поделиться через