ControlExtensions.AddDataGridView – metoda (ControlCollection, Range, Single, Single, String)

Článek
08/11/2011

Přidá nový DataGridView Řízení dokumentů v zadané velikosti a umístění.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word.v4.0.Utilities (v Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntaxe

'Deklarace
<ExtensionAttribute> _
Public Shared Function AddDataGridView ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As DataGridView

public static DataGridView AddDataGridView(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

Parametry

controls
Typ: Microsoft.Office.Tools.Word.ControlCollection
kolekce přidat ovládací prvek.Nezadávejte tento parametr sami.Při volání této metody ve vrácené kolekci Document.Controls Vlastnosti (v úrovni aplikace project) nebo DocumentBase.Controls Vlastnosti (v úrovni dokumentu projektu) je tento parametr zadán automaticky.

range
Typ: Microsoft.Office.Interop.Word.Range
Umístění ovládacího prvku.

width
Typ: System.Single
Šířka ovládacích bodů.

height
Typ: System.Single
Výška ovládacích bodů.

name
Typ: System.String
Název, který může být použit index řízení v ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.Controls.DataGridView
Ovládací prvek přidaný do dokumentu.

Poznámka k použití

V jazycích Visual Basic a C# lze tuto metodu volat jako metodu instance libovolného objektu typu ControlCollection. Pokud k volání této metody použijete syntaxi metody instance, vynechejte první parametr. Další informace naleznete v tématech Extension Methods (Visual Basic) a Extension Methods (C# Programming Guide).

Výjimky

Výjimka	Podmínka
ArgumentNullException	name Nebo range argument je nullodkaz Null (Nothing v jazyce Visual Basic), nebo name argument má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již v ControlCollection instance.
InvalidRangeException	Určený rozsah je platný.

Poznámky

Tato metoda umožňuje přidat DataGridView objekty na konci ControlCollection.

Odebrání DataGridView , byl přidán programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá DataGridView řízení prvního odstavce v dokumentu a potom přidá dva sloupce ovládacího prvku. Chcete-li použít tento příklad spustit z ThisDocument třídy v projektu úrovni dokumentu.

Private Sub WordRangeAddDataGridView()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim DataGridView1 As Microsoft.Office.Tools.Word. _
        Controls.DataGridView = Me.Controls.AddDataGridView( _
        Me.Paragraphs(1).Range, 190, 112.5F, "DataGridView1")
    DataGridView1.Columns.Add("firsName", "First Name")
    DataGridView1.Columns.Add("lastName", "Last Name")
End Sub

private void WordRangeAddDataGridView()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.DataGridView
        dataGridView1 = this.Controls.AddDataGridView(
        this.Paragraphs[1].Range, 190, 112.5F, "dataGridView1");
    dataGridView1.Columns.Add("firsName", "First Name");
    dataGridView1.Columns.Add("lastName", "Last Name");
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Odkaz

ControlExtensions Třída

AddDataGridView – přetížení

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím