Пошаговое руководство. Отображение текста в текстовом поле документа с помощью кнопки

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

Применение
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта Проекты уровня документа Версия Microsoft Office Word 2007 Word 2003 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

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

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

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

• заполнение текстового поля при нажатии кнопки.

Примечание.
На вашем компьютере названия некоторых элементов интерфейса пользователя 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.

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

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

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

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

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

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

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

Рассматриваемый элемент интерфейса пользователя для документов Word состоит из кнопки и текстового поля.

Добавление кнопки и текстового поля

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

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

   Примечание.
   По умолчанию в Word для элементов управления используется стиль обтекания "В тексте". Можно изменить способ вставки в документ элементов управления и объектов фигур на вкладке Правка диалогового окна Параметры.

3. В меню Вид выберите пункт Окно свойств.

4. Найдите элемент TextBox1 в раскрывающемся списке окна Свойства и присвойте его свойству Name значение displayText.

5. Перетащите элемент управления Button на документ и измените следующие свойства.

   Свойство	Значение
   Имя	insertText
   Текст	Вставить текст

Теперь напишите код, который будет выполняться при нажатии кнопки.

Заполнение текстового поля при нажатии кнопки

При каждом нажатии кнопки строка Hello World! будет добавляться к содержимому текстового поля.

Запись в текстовое поле строки при нажатии кнопки

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

2. В обработчик событий кнопки Click добавьте следующий код.

   Private Sub insertText_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles insertText.Click
   
       Me.displayText.Text += "Hello World!"
   End Sub
   

   private void insertText_Click(object sender, EventArgs e)
   {
       this.displayText.Text += "Hello World!";
   }
   

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

   this.insertText.Click += new EventHandler(insertText_Click);
   

Проверка работы приложения

Теперь можно проверить работу документа, чтобы убедиться, что при нажатии кнопки сообщение Hello World! отображается в текстовом поле.

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

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

2. Нажмите кнопку.

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

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

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

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

• Использование переключателей для выбора стилей диаграмм. Дополнительные сведения см. в разделе Пошаговое руководство. Обновление диаграммы в документе с помощью переключателей.

См. также

Задачи

Практическое руководство. Добавление элементов управления Windows Forms в документы Office

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

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

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

Общие сведения о ведущих элементах и элементах управления ведущего приложения

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

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