Método ControlExtensions.AddDataGridView (ControlCollection, Single, Single, Single, Single, String)
Adiciona um novo controle de DataGridView ao documento no tamanho e no local especificado.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Sintaxe
'Declaração
<ExtensionAttribute> _
Public Shared Function AddDataGridView ( _
controls As ControlCollection, _
left As Single, _
top As Single, _
width As Single, _
height As Single, _
name As String _
) As DataGridView
public static DataGridView AddDataGridView(
this ControlCollection controls,
float left,
float top,
float width,
float height,
string name
)
Parâmetros
- controls
Tipo: Microsoft.Office.Tools.Word.ControlCollection
A coleção para adicionar ao controle.Não fornecer este parâmetro você mesmo.Quando você chamar esse método retornar a coleção Document.Controls propriedade (um nível do projeto) ou DocumentBase.Controls propriedade (a um nível projeto), este parâmetro estar fornecer automaticamente.
- left
Tipo: System.Single
Os pontos a distância entre a borda esquerda do controle e a borda esquerda do documento.
- top
Tipo: System.Single
Os pontos a distância entre a borda superior do controle e a borda superior do documento.
- width
Tipo: System.Single
A largura do controle em pontos.
- height
Tipo: System.Single
A altura do controle em pontos.
- name
Tipo: System.String
O nome que pode ser usado para indexar o controle na instância de ControlCollection .
Valor de retorno
Tipo: Microsoft.Office.Tools.Word.Controls.DataGridView
O controle que foi adicionado ao documento.
Observação de uso
No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo ControlCollection. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (guia de programação do C#).
Exceções
Exceção | Condição |
---|---|
ArgumentNullException | O argumento de name é nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero. |
ControlNameAlreadyExistsException | Um controle com o mesmo nome já está na instância de ControlCollection . |
Comentários
Esse método permite que você adicione objetos de DataGridView ao final de ControlCollection.
Para remover DataGridView que foi adicionado por meio de programação, use o método de Remove .
Exemplos
O exemplo de código a seguir adiciona um controle de DataGridView para o início do documento, e então adiciona duas colunas ao controle.Para usar este exemplo, ele execução da classe de ThisDocument em um projeto de um documento nível.
Private Sub WordAddDataGridView()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim DataGridView1 As Microsoft.Office.Tools.Word. _
Controls.DataGridView = Me.Controls.AddDataGridView( _
0, 0, 190, 112.5F, "DataGridView1")
DataGridView1.Columns.Add("firsName", "First Name")
DataGridView1.Columns.Add("lastName", "Last Name")
End Sub
private void WordAddDataGridView()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Controls.DataGridView
dataGridView1 = this.Controls.AddDataGridView(
0, 0, 190, 112.5F, "dataGridView1");
dataGridView1.Columns.Add("firsName", "First Name");
dataGridView1.Columns.Add("lastName", "Last Name");
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.