Métodos auxiliares para controles Windows Forms
Você pode programaticamente adicionar controles Windows Forms a um documento do Word de Microsoft Office e a pasta de trabalho do Excel de Microsoft Office em tempo de execução usando métodos auxiliares que estão disponíveis em seu projeto. For more information, see Adicionar controles a documentos do Office em tempo de execução.
Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para os seguintes aplicativos: Excel 2007 e Excel 2010; Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.
Métodos auxiliares para Excel
Para adicionar controles Windows Forms para uma planilha em tempo de execução, use os métodos auxiliares que estão disponíveis na ControlCollection objeto retornado pela Worksheet.Controls propriedade (em um projeto de nível de aplicativo) ou o WorksheetBase.Controls propriedade (em um projeto de nível de documento). Cada método auxiliar está sobrecarregado para que você pode passar um Range ou as coordenadas de um local específico. Quando você cria um controle passando por um Range, o controle é redimensionado automaticamente quando as células dentro do intervalo são redimensionadas.
.gif "Observação") Observação |
|---|
No Excel add-in de projetos destinados a .NET Framework 4, você deve adicionar uma referência ao assembly Microsoft.Office.Tools.Excel.v4.0.Utilities.dll antes de poder acessar os métodos auxiliares. |
A tabela a seguir lista os métodos auxiliares que podem ser usadas para programaticamente adicionar controles Windows Forms para pastas de trabalho do Excel.
Método auxiliar |
Description |
|---|---|
Adiciona um Button o controle no intervalo especificado. |
|
AddButton(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um Button o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um Label o controle no intervalo especificado. |
|
AddLabel(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um Label o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um LinkLabel o controle no intervalo especificado. |
|
AddLinkLabel(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um LinkLabel o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um TextBox o controle no intervalo especificado. |
|
AddTextBox(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um TextBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um CheckBox o controle no intervalo especificado. |
|
AddCheckBox(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um CheckBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um RadioButton o controle no intervalo especificado. |
|
AddRadioButton(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um RadioButton o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um PictureBox o controle no intervalo especificado. |
|
AddPictureBox(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um PictureBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um CheckedListBox o controle no intervalo especificado. |
|
AddCheckedListBox(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um CheckedListBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um ComboBox o controle no intervalo especificado. |
|
AddComboBox(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um ComboBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um ListView o controle para o intervalo especificado, definindo a posição e tamanho do controle. |
|
AddListView(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um ListView o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um TreeView o controle no intervalo especificado. |
|
AddTreeView(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um TreeView o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um DateTimePicker o controle no intervalo especificado. |
|
AddDateTimePicker(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um DateTimePicker o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um MonthCalendar o controle no intervalo especificado. |
|
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um MonthCalendar o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um DomainUpDown o controle no intervalo especificado. |
|
AddDomainUpDown(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um DomainUpDown o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um NumericUpDown o controle no intervalo especificado. |
|
AddNumericUpDown(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um NumericUpDown o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um TrackBar o controle no intervalo especificado. |
|
AddTrackBar(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um TrackBar o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um RichTextBox o controle no intervalo especificado. |
|
AddRichTextBox(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um RichTextBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um DataGridView o controle no intervalo especificado. |
|
AddDataGridView(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um DataGridView o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um HScrollBar o controle no intervalo especificado. |
|
AddHScrollBar(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um HScrollBar o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um VScrollBar o controle no intervalo especificado. |
|
AddVScrollBar(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um VScrollBar o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um PropertyGrid o controle no intervalo especificado. |
|
AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um PropertyGrid o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um WebBrowser o controle no intervalo especificado. |
|
AddWebBrowser(ControlCollection, Double, Double, Double, Double, String) |
Adiciona um WebBrowser o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Métodos auxiliares para Word
Para adicionar controles Windows Forms a um documento em tempo de execução, use os métodos auxiliares que estão disponíveis na ControlCollection objeto retornado pela Document.Controls propriedade (em um projeto de nível de aplicativo) ou o DocumentBase.Controls propriedade (em um projeto de nível de documento). Cada método é sobrecarregado para que você pode passar um Range ou as coordenadas de um local específico. Quando você cria um controle passando por um Range, o controle é adicionado como um InlineShape no início do intervalo. Não é possível alterar o Top e Left Propriedades de controles que são adicionados alinhado com texto. Quando você cria um controle passando as coordenadas, o controle é adicionado como um flutuante Shape o local especificado.
| Observação |
|---|
No Word add-in de projetos destinados a .NET Framework 4, você deve adicionar uma referência ao assembly Microsoft.Office.Tools.Word.v4.0.Utilities.dll antes de poder acessar os métodos auxiliares. |
A tabela a seguir lista os métodos auxiliares que podem ser usadas para programaticamente adicionar controles Windows Forms em documentos do Word.
Método auxiliar |
Description |
|---|---|
Adiciona um Button o controle no início do intervalo especificado. |
|
AddButton(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um Button o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Adiciona um Label o controle no início do intervalo especificado. |
|
AddLabel(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um Label o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddLinkLabel(ControlCollection, Range, Single, Single, String) |
Adiciona um LinkLabel o controle no início do intervalo especificado. |
AddLinkLabel(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um LinkLabel o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddTextBox(ControlCollection, Range, Single, Single, String) |
Adiciona um TextBox o controle no início do intervalo especificado. |
AddTextBox(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um TextBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddCheckBox(ControlCollection, Range, Single, Single, String) |
Adiciona um CheckBox o controle no início do intervalo especificado. |
AddCheckBox(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um CheckBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddRadioButton(ControlCollection, Range, Single, Single, String) |
Adiciona um RadioButton o controle no início do intervalo especificado. |
AddRadioButton(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um RadioButton o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddPictureBox(ControlCollection, Range, Single, Single, String) |
Adiciona um PictureBox o controle no início do intervalo especificado. |
AddPictureBox(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um PictureBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddCheckedListBox(ControlCollection, Range, Single, Single, String) |
Adiciona um CheckedListBox o controle no início do intervalo especificado. |
AddCheckedListBox(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um CheckedListBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddComboBox(ControlCollection, Range, Single, Single, String) |
Adiciona um ComboBox o controle no início do intervalo especificado. |
AddComboBox(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um ComboBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddListView(ControlCollection, Range, Single, Single, String) |
Adiciona um ListView o controle para o intervalo especificado, definindo a posição e tamanho do controle. |
AddListView(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um ListView o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddTreeView(ControlCollection, Range, Single, Single, String) |
Adiciona um TreeView o controle no início do intervalo especificado. |
AddTreeView(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um TreeView o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddDateTimePicker(ControlCollection, Range, Single, Single, String) |
Adiciona um DateTimePicker o controle no início do intervalo especificado. |
AddDateTimePicker(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um DateTimePicker o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddMonthCalendar(ControlCollection, Range, Single, Single, String) |
Adiciona um MonthCalendar o controle no início do intervalo especificado. |
AddMonthCalendar(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um MonthCalendar o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddDomainUpDown(ControlCollection, Range, Single, Single, String) |
Adiciona um DomainUpDown o controle no início do intervalo especificado. |
AddDomainUpDown(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um DomainUpDown o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddNumericUpDown(ControlCollection, Range, Single, Single, String) |
Adiciona um NumericUpDown o controle no início do intervalo especificado. |
AddNumericUpDown(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um NumericUpDown o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddTrackBar(ControlCollection, Range, Single, Single, String) |
Adiciona um TrackBar o controle no início do intervalo especificado. |
AddTrackBar(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um TrackBar o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddRichTextBox(ControlCollection, Range, Single, Single, String) |
Adiciona um RichTextBox o controle no início do intervalo especificado. |
AddRichTextBox(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um RichTextBox o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddDataGridView(ControlCollection, Range, Single, Single, String) |
Adiciona um DataGridView o controle no início do intervalo especificado. |
AddDataGridView(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um DataGridView o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddHScrollBar(ControlCollection, Range, Single, Single, String) |
Adiciona um HScrollBar o controle no início do intervalo especificado. |
AddHScrollBar(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um HScrollBar o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddVScrollBar(ControlCollection, Range, Single, Single, String) |
Adiciona um VScrollBar o controle no início do intervalo especificado. |
AddVScrollBar(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um VScrollBar o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddPropertyGrid(ControlCollection, Range, Single, Single, String) |
Adiciona um PropertyGrid o controle no início do intervalo especificado. |
AddPropertyGrid(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um PropertyGrid o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
AddWebBrowser(ControlCollection, Range, Single, Single, String) |
Adiciona um WebBrowser o controle no início do intervalo especificado. |
AddWebBrowser(ControlCollection, Single, Single, Single, Single, String) |
Adiciona um WebBrowser o controle na posição especificada, em vez de fazê-lo em um intervalo. As coordenadas são representadas em pontos. |
Consulte também
Conceitos
Adicionar controles a documentos do Office em tempo de execução
Controles do Windows Forms em Visão geral de documentos do Office
Limitações dos controles do Windows Forms em documentos do Office