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

Пошаговое руководство. Изменение форматирования документа с использованием элементов управления CheckBox

  • Статья

Обновлен: Ноябрь 2007

Применение

Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office.

Тип проекта

  • Проекты уровня документа

Версия Microsoft Office

  • Word 2007

  • Word 2003

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

В этом пошаговом руководстве демонстрируются принципы использования элементов управления Windows Forms для изменения форматирования текста в настройке уровня документа для Microsoft Office Word.

В данном пошаговом руководстве рассмотрены следующие задачи:

  • Добавление текста и элемента управления в документ в проекте уровня документа во время разработки.

  • Форматирование текста при выборе параметра.

Результат полностью выполненного примера см. в разделе Пример Word Controls.

8w0635zd.alert_note(ru-ru,VS.90).gifПримечание.

На вашем компьютере названия некоторых элементов интерфейса пользователя Visual Studio или их расположение могут отличаться от указанных в нижеследующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Параметры Visual Studio.

Обязательные компоненты

Ниже приведены компоненты, необходимые для выполнения данного пошагового руководства.

  • Visual Studio Tools for Office (необязательный компонент Visual Studio 2008 Professional и Visual Studio Team System).

  • Microsoft Office Word 2003 или Microsoft Office Word 2007.

Visual Studio Tools for Office устанавливается по умолчанию с перечисленными версиями Visual Studio. Чтобы проверить, установлен ли данный пакет инструментов, см. раздел Установка средств Visual Studio для Office.

Создание проекта

Для начала следует создать проект документа Word.

Создание нового проекта

  • Создайте проект документа Word с именем Форматирование Word. В мастере выберите Создать новый документ.

    Дополнительные сведения см. в разделе Практическое руководство. Создание проектов Visual Studio Tools for Office.

    Visual Studio откроет новый документ Word в конструкторе и добавит проект Форматирование Word в обозреватель решений.

Добавление текста и элементов управления к документу Word

В этом пошаговом руководстве выполняется добавление трех флажков и текста в элемент управления Bookmark в документе Word. Флажки представляют пользователю параметры форматирования текста.

Добавление трех флажков

  1. Следует убедиться, что документ открыт в конструкторе Visual Studio.

  2. Перетащите в документ элемент управления CheckBox со вкладки Стандартные элементы управления в панели элементов.

  3. В окне Свойства измените следующие свойства:

    Свойство

    Значение

    Name

    applyBoldFont

    Text

    Полужирный

  4. Нажмите клавишу ВВОД, чтобы переместить точку вставки под первый флажок.

  5. Добавьте в документ второй флажок под флажком ApplyBoldFont и измените следующие свойства:

    Свойство

    Значение

    Name

    applyItalicFont

    Text

    Курсив

  6. Нажмите клавишу ВВОД, чтобы переместить точку вставки под второй флажок.

  7. Добавьте в документ третий флажок под флажком ApplyItalicFont и измените следующие свойства:

    Свойство

    Значение

    Name

    applyUnderlineFont

    Text

    Подчеркнутый

Добавление текста и элемента управления Bookmark

  1. Переместите точку вставки под флажки и введите следующий текст:

    Установите соответствующий флажок, чтобы изменить форматирование текста.

  2. Перетащите в документ элемент управления Bookmark со вкладки Элементы управления Word в панели элементов.

    Появится диалоговое окно Добавить элемент управления закладками.

  3. Выделите текст, добавленный в документ, и нажмите кнопку ОК.

    К выделенному тексту добавится элемент управления Bookmark с именем Bookmark1.

  4. В окне Свойства следует изменить значение свойства (Name) на fontText**.**

Далее следует написать код форматирования текста при установке или снятии флажка.

Форматирование текста при установке или снятии флажка

При выборе пользователем параметров форматирования формат текста в документе следует изменить.

Изменение форматирования при установке флажка

  1. В обозревателе решений щелкните правой кнопкой мыши ThisDocument и выберите в контекстном меню команду Перейти к коду.

  2. Добавьте в класс ThisDocument следующие константы (только в C#):

    const int WordTrue = -1;
const int WordFalse = 0;

  3. Добавьте следующий код к обработчику событий Click флажка applyBoldFont:

    Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles applyBoldFont.Click

    Me.fontText.Bold = Me.applyBoldFont.Checked
End Sub

    private void applyBoldFont_Click(object sender, System.EventArgs e)
{
    if (this.applyBoldFont.Checked == true)
    {
        this.fontText.Bold = WordTrue;
    }
    else
    {
        this.fontText.Bold = WordFalse;
    }
}

  4. Добавьте следующий код к обработчику событий Click флажка applyItalicFont:

    Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles applyItalicFont.Click

    Me.fontText.Italic = Me.applyItalicFont.Checked
End Sub

    private void applyItalicFont_Click(object sender, System.EventArgs e)
{
    if (this.applyItalicFont.Checked == true)
    {
        this.fontText.Italic = WordTrue;
    }
    else
    {
        this.fontText.Italic = WordFalse;
    }
}

  5. Добавьте следующий код к обработчику событий Click флажка applyUnderlineFont:

    Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles applyUnderlineFont.Click

    If Me.applyUnderlineFont.Checked Then
        Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle
    Else
        Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone
    End If
End Sub

    private void applyUnderlineFont_Click(object sender, System.EventArgs e)
{
    if (this.applyUnderlineFont.Checked == true)
    {
        this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle;
    }
    else
    {
        this.fontText.Underline = Word.WdUnderline.wdUnderlineNone;
    }
}

  6. В C# также необходимо добавить обработчики событий для текстовых колей к событию Startup. Дополнительные сведения о создании обработчиков событий см. в разделе Практическое руководство. Создание обработчиков событий в пакете инструментов Visual Studio для Office.

    this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);

Чтобы проверить работу приложения

Теперь можно правильность форматирования текста документа при установке или снятии флажков.

Тестирование документа

  1. Нажмите клавишу F5 для запуска проекта.

  2. Установите или снимите флажок.

  3. Убедитесь, что применяется правильное форматирование текста.

Следующие действия

В этом пошаговом руководстве описываются основы программного изменения форматирования текста в документах Word. Далее будут рассмотрены следующие задачи:

См. также

Основные понятия

Пошаговые руководства с использованием Word

Элемент управления NamedRange

Ограничения по использованию элементов управления Windows Forms в документах Office

Другие ресурсы

Образцы и пошаговые руководства разработки Office