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

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

  • Статья

Обновлен: Июль 2008

Применение

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

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

  • Excel 2003

  • Excel 2007

  • Word 2003

  • Word 2007

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

  • Excel 2007

  • Word 2007

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

Элементы управления Windows Forms можно добавлять в документы Microsoft Office Excel и Microsoft Office Word во время разработки в проектах на уровне документа. Во время выполнения можно добавлять элементы управления в настройках уровня документа и в надстройках уровня приложения. Например, можно добавить на лист элемент управления ComboBox, обеспечивающий выбор параметров в списке.

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

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

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

  • Добавление элементов управления во время выполнения в надстройках уровня приложения

Также в документы Office можно добавить элементы управления ведущего приложения, например Bookmark и NamedRange. Дополнительные сведения см. в разделах Элементы управления ведущего приложения Word и Элементы управления ведущего приложения Excel.

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

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

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

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

Перетаскивание элементов управления Windows Forms в документ

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

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

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

    При выборе элемента управления в Excel в строке формул отображается текст =EMBED("WinForms.Control.Host",""). Этот текст является обязательным и не подлежит удалению.

Рисование элементов управления Windows Forms в документе

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

  2. Щелкните необходимый элемент управления на вкладке Стандартные элементы управленияпанели элементов.

  3. Щелкните место в документе, где должен располагаться левый верхний угол элемента управления, а затем перетащите указатель мыши на место, в котором должен располагаться правый нижний угол элемента управления.

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

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

    При выборе элемента управления в Excel в строке формул отображается текст =EMBED("WinForms.Control.Host",""). Этот текст является обязательным и не подлежит удалению.

Добавление элемента управления Windows Forms в документ одним щелчком мыши

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

  2. Щелкните необходимый элемент управления на вкладке Стандартные элементы управленияпанели элементов.

  3. Щелкните место в документе, в котором необходимо добавить элемент управления.

    Элемент управления с размерами по умолчанию добавляется в указанное место документа.

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

    При выборе элемента управления в Excel в строке формул отображается текст =EMBED("WinForms.Control.Host",""). Этот текст является обязательным и не подлежит удалению.

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

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

  2. Дважды щелкните необходимый элемент управления на вкладке Стандартные элементы управления панели элементов.

    Элемент управления добавляется в центре документа или активной области.

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

    При выборе элемента управления в Excel в строке формул отображается текст =EMBED("WinForms.Control.Host",""). Этот текст является обязательным и не подлежит удалению.

Добавление элемента управления Windows Forms в документ нажатием клавиши ВВОД

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

  2. Щелкните необходимый элемент управления на вкладке Стандартные элементы управленияпанели элементов и нажмите клавишу ВВОД.

    Элемент управления добавляется в центре документа или активной области.

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

    При выборе элемента управления в Excel в строке формул отображается текст =EMBED("WinForms.Control.Host",""). Этот текст является обязательным и не подлежит удалению.

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

Можно добавлять элементы управления Windows Forms в документ во время выполнения программными средствами. В Word следует использовать методы свойства Controls класса ThisDocument. В Excel используются методы свойства Controls класса Sheetn. Каждый метод имеет несколько перегрузок, что позволяет указать расположение элемента управления разными способами. Дополнительные сведения см. в разделе Вспомогательные методы для элементов управления Windows Forms.

Если элемент управления Windows Forms добавляется в документ во время разработки, то этот элемент управления не сохраняется в документе после его закрытия. Этот элемент управления можно пересоздать при следующем открытии документа. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

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

  • Следует использовать метод Microsoft.Office.Tools.Word.ControlCollection (для проектов Word) или метод Microsoft.Office.Tools.Excel.ControlCollection (для проектов Excel) с именем Add<класс_элемента_управления> (где класс_элемента_управления представляет имя класса элемента управления Windows Forms, который требуется добавить, например AddButton).

    В следующем примере кода демонстрируется порядок добавления элемента управления Button в ячейку C5 листа Sheet1 в проекте уровня документа для Excel.

    Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    Dim salesButton As Microsoft.Office.Tools.Excel.Controls.Button
    salesButton = Me.Controls.AddButton(Me.Range("C5"), "salesButton")
    salesButton.Text = "Calculate Total Sales"
End Sub

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button salesButton;
    salesButton = this.Controls.AddButton(this.get_Range("C5", missing), "salesButton");
    salesButton.Text = "Calculate Total Sales";
}

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

Можно добавлять элементы управления Windows Forms в любой открытый документ во время выполнения программными средствами. Сначала нужно создать ведущий элемент на основе открытого документа или листа. Затем в Word следует воспользоваться методами свойства Document.Controls созданного ведущего элемента. В Excel же следует воспользоваться методами свойства Worksheet.Controls созданного ведущего элемента. Каждый метод имеет несколько перегрузок, что позволяет указать расположение элемента управления разными способами. Дополнительные сведения см. в разделе Вспомогательные методы для элементов управления Windows Forms.

Если элемент управления Windows Forms добавляется в документ во время разработки, то этот элемент управления не сохраняется в документе после его закрытия. Этот элемент управления можно пересоздать при следующем открытии документа. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

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

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

  • Следует использовать метод Microsoft.Office.Tools.Word.ControlCollection (для проектов Word) или метод Microsoft.Office.Tools.Excel.ControlCollection (для проектов Excel) с именем Add<класс_элемента_управления> (где класс_элемента_управления представляет имя класса элемента управления Windows Forms, который требуется добавить, например AddButton).

    В следующем примере кода демонстрируется порядок добавления элемента управления Button в первый параграф активного документа с помощью надстройки Word.

    Dim salesButton As Microsoft.Office.Tools.Word.Controls.Button
Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()

extendedDocument.Paragraphs(1).Range.InsertParagraphBefore()
salesButton = extendedDocument.Controls.AddButton( _
    extendedDocument.Paragraphs(1).Range, 75, 18, "salesButton")
salesButton.Text = "Calculate Sales"

    Microsoft.Office.Tools.Word.Controls.Button salesButton;
Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();

extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
salesButton = extendedDocument.Controls.AddButton(
    extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
salesButton.Text = "Calculate Sales";

См. также

Задачи

Практическое руководство. Изменение размера внутри ячеек листа Excel

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

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

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

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

Общие сведения о необязательных параметрах в решениях Office

Журнал изменений

Дата

Журнал изменений

Причина

Июль 2008

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

Изменение функции SP1.