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

Статья
03/25/2013

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

Применение. Сведения этого раздела применяются к проектам уровня документа и уровня приложения для следующих приложений: Excel 2013 и Excel 2010; Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

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

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

ссылка на видео Для просмотра связанных демонстрационных видеороликов перейдите по ссылке How Do I: Add Controls to a Document Surface at Runtime? (на английском языке).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Используйте метод с именем 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"), "salesButton");
    salesButton.Text = "Calculate Total Sales";
}

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

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

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

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

Примечание
В проектах надстройки уровня приложения, целевой объект .NET Framework 4 или .NET Framework 4.5, необходимо добавить ссылку на сборку Microsoft.Office.Tools.Excel.v4.0.Utilities.dll или Microsoft.Office.Tools.Word.v4.0.Utilities.dll перед получением доступа к методы Add<Класс control>.

В проектах надстройки уровня приложения, целевой объект .NET Framework 4 или .NET Framework 4.5, необходимо добавить ссылку на сборку Microsoft.Office.Tools.Excel.v4.0.Utilities.dll или Microsoft.Office.Tools.Word.v4.0.Utilities.dll перед получением доступа к методы Add<Класс control>.

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

Dim salesButton As Microsoft.Office.Tools.Word.Controls.Button

Dim extendedDocument As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

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 = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);


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