Пошаговое руководство. Вставка текста в документ из панели действий

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

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

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

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

• Проектирование интерфейса с помощью элементов управления Windows Forms на элементе управления панели действий.

• Отображение панели действий при открытии приложения.

Примечание.
На компьютере могут отображаться разные имена или расположения некоторых элементов пользовательского интерфейса 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 с именем My Basic Actions Pane. Выберите в мастере Создать новый документ. Дополнительные сведения см. в разделе Практическое руководство. Создание проектов Visual Studio Tools for Office.

  Visual Studio откроет новый документ Word в режиме конструктора и добавит проект My Basic Actions Pane в Обозреватель Решений.

Добавление текста и закладок в документ

Панель действий будет посылать текст в закладки документа. Чтобы сконструировать документ, введете какой-либо текст в основную форму.

Добавление текста в документ

• Введите следующий текст в документ Word:

  21 марта, 2008

  Имя

  Адрес

  Это пример базовой панели действий в Word.

Можно добавить элемент управления Bookmark к документу, перетащив его из элемента Панель элементов в Visual Studio или используя диалоговое окно Закладка в Word.

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

1. Из закладки Элементы управления Word объекта Панель элементов перетащите элемент управления Bookmark в документ.

   Откроется диалоговое окно Добавление элемента управления "Закладка".

2. Выберите слово Имя, не выбирая знак абзаца, и нажмите кнопку ОК.

   Примечание.
   Знак абзаца должен находиться вне закладки. Если знаки абзаца невидимы в документе, щелкните меню Сервис, укажите пункт Средства Microsoft Office Word, и затем щелкните пункт Параметры. Щелкните вкладку Вид, и установите флажок Знаки абзаца в разделе Знаки форматирования диалогового окна Параметры.

3. В окне Свойства, измените свойство Name объекта Bookmark1 на showName.

4. Выберите слово Адрес, не выбирая знак абзаца.

5. Выполните один из следующих шагов:

   • Для Word 2003: в меню Вставка выберите пункт Закладка.

   • Для Word 2007: во вкладке Вставка на ленте, в группе Связи щелкните Закладка.

6. В диалоговом окне Закладка введите showAddress в поле Имя закладки и щелкните пункт Добавить.

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

Для разработки интерфейса панели действий, добавьте элемент управления панели действия к проекту, и затем добавьте элементы управления Windows Forms к элементу управления панели действий.

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

1. Выберите проект Моя базовая панель действий в Обозревателе решений.

2. В меню Проект выберите команду Добавить новый элемент.

3. В диалоговом окне Добавить новый элемент щелкните Элемент управления панелью действий, назовите элемент управления InsertTextControl, и нажмите кнопку Добавить.

Добавление элементов управления Windows Forms в первый элемент управления панели действий

1. Если панель действий невидима в конструкторе, дважды щелкните InsertTextControl.

2. Со вкладки Общие элементы управленияпанели элементов, перетащите элемент управления Label на элемент управления панели действий.

3. Измените значение свойства Text элемента управления "Метка" на Имя.

4. Добавьте элемент управления TextBox к элементу управления панели действий и измените следующие свойства.

   Свойство	Значение
   Name	getName
   Size	130, 20

5. Добавьте второй элемент управления Label к элементу управления панели действий и измените значение свойства Text на Address.

6. Добавьте второй элемент управления TextBox к элементу управления панели действий и измените следующие свойства.

   Свойство	Значение
   Name	getAddress
   Accepts Return	True
   Multiline	True
   Size	130, 40

7. Добавьте элемент управления Button к элементу управления панели действий и измените следующие свойства.

   Свойство	Значение
   Name	addText
   Text	Вставить

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

В панели действий введите код, который вставляет текст и текстовые поля в соответствующие элементы управления Bookmark в документе. Можно использовать класс Globals для доступа к элементам управления в документе из элементов управления в панели действий. Дополнительные сведения см. в разделе Глобальный доступ к объектам в Visual Studio Tools for Office.

Вставка текста из панели действий в закладку документа

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

   Private Sub addText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles addText.Click
   
       If Me.getName.Text <> String.Empty Then
           Globals.ThisDocument.showName.Text = Me.getName.Text
       End If
   
       If Me.getAddress.Text <> String.Empty Then
           Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
       End If
   
       Me.getName.Text = String.Empty
       Me.getAddress.Text = String.Empty
   End Sub
   

   private void addText_Click(object sender, System.EventArgs e)
   {
       if (this.getName.Text != String.Empty) 
       {
           Globals.ThisDocument.showName.Text = this.getName.Text;
       }
   
       if (this.getAddress.Text != String.Empty)
       {
           Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
       }
   
       this.getName.Text = String.Empty;
       this.getAddress.Text = String.Empty;
   }
   

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

   public InsertTextControl()
   {
       InitializeComponent();
       this.addText.Click += new EventHandler(addText_Click);
   }
   

Добавление кода для показа панели действий

Чтобы показать панель действий, добавьте элемент управления, включенный в коллекцию элемента управления.

Отображение панели действий

1. Создайте новый экземпляр управляющего элемента панели действий в классе ThisDocument.

   Dim insertText As New InsertTextControl
   

   private InsertTextControl insertText = new InsertTextControl();
   

2. Добавьте следующий код в обработчик событий Startup книги ThisDocument.

   Me.ActionsPane.Controls.Add(insertText)
   

   this.ActionsPane.Controls.Add(insertText);
   

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

Протестируйте документ, чтобы убедиться, что панель действий открывается при открытии документа и что текст, вводимый в текстовые поля, помещается в закладки при нажатии кнопки.

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

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

2. Убедитесь, что панель действий отображается.

3. Введите имя и адрес в текстовые поля в панели действий и щелкните Вставить.

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

Далее будут рассмотрены следующие задачи:

• Создание панели действий в Excel. Дополнительные сведения см. в разделе Практическое руководство. Добавление панели действий в книги Excel.

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

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

См. также

Задачи

Практическое руководство. Добавление панели действий в документы Word

Практическое руководство. Добавление панели действий в книги Excel

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

Практическое руководство. Управление структурой элементов управления в панели действий

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

Общие сведения о панели действий

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