Método ControlExtensions.AddDataGridView (ControlCollection, Single, Single, Single, Single, String)
Adiciona um novo DataGridView o controle para o documento em que o tamanho especificado e o local.
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 o controle.Não forneça esse parâmetro sozinho.Quando você chamar esse método na coleção retornada com o Document.Controls propriedade (em um projeto de nível de aplicativo) ou o DocumentBase.Controls propriedade (em um projeto de nível de documento), este parâmetro é fornecido automaticamente.
- left
Tipo: System.Single
A distância em pontos entre a borda esquerda do controle e a borda esquerda do documento.
- top
Tipo: System.Single
A distância em pontos 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 de ControlCollection instância.
Valor de retorno
Tipo: Microsoft.Office.Tools.Word.Controls.DataGridView
O controle 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 TRANSLATION FROM VPE FOR CSHARP).
Exceções
Exceção | Condição |
---|---|
ArgumentNullException | O name argumento é nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero. |
ControlNameAlreadyExistsException | Um controle com o mesmo nome já está na ControlCollection instância. |
Comentários
Esse método permite que você adicione DataGridView objetos no final da ControlCollection.
Para remover um DataGridView que foi adicionado programaticamente, use o Remove método.
Exemplos
O exemplo de código a seguir adiciona um DataGridView o controle para o início do documento e em seguida, adiciona duas colunas no controle. Para usar esse exemplo, executá-lo do ThisDocument a classe em um projeto de nível de documento.
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.