ControlCollection.AddControl – metoda (Control, Single, Single, Single, Single, String)

Článek
05/14/2013

Přidá zadaný ovládací prvek ControlCollection v zadaném umístění zadané velikosti.

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

Syntaxe

'Deklarace
Function AddControl ( _
    control As Control, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As ControlSite

ControlSite AddControl(
    Control control,
    float left,
    float top,
    float width,
    float height,
    string name
)

Parametry

control
Typ: System.Windows.Forms.Control
Ovládací prvek, který má být přidán k ControlCollection instance.

left
Typ: System.Single
Vzdálenost mezi levým okrajem ovládacího prvku a levým okrajem dokumentu body.

top
Typ: System.Single
Vzdálenost mezi horním okrajem ovládacího prvku a horním okrajem dokumentu body.

width
Typ: System.Single
Šířku ovládacího prvku v bodech.

height
Typ: System.Single
Výška ovládacího prvku v bodech.

name
Typ: System.String
Název ovládacího prvku.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.ControlSite
Objekt, který představuje ovládací prvek, který obsahuje zadaný ovládací prvek v dokumentu.

Výjimky

Výjimka	Podmínka
ArgumentNullException	name 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ž ControlCollection instance.
ControlCouldNotBeInitializedException	The control argument is nullodkaz null (Nothing v jazyce Visual Basic).

Poznámky

Tuto metodu lze použít libovolný ovládací prvek přidat ControlCollection v době běhu.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů sady Office v době spuštění.

Příklady

Následující příklad kódu přidá do dokumentu pomocí dvou vlastních uživatelských ovládacích prvků AddControl metoda.První ovládací prvek je přidán do Range.Druhý ovládací prvek je přidán do určitého umístění.Změny kódu Top vlastnost první vlastní uživatelský ovládací prvek, který pouze přesune ovládací prvek, vzhledem k ControlSite , která obsahuje ovládací prvek v dokumentu.Kód potom nastaví Top vlastnost ControlSite vrácené druhý ovládací prvek uživatele ilustrovat správný způsob, jak nastavit Top vlastnost ovládacího prvku.

Private Sub WordRangeAddControl()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim CustomUserControl As New UserControl1()
    Dim CustomUserControl2 As New UserControl2()

    Dim DynamicControl As Microsoft.Office.Tools.Word.ControlSite = _
        Me.Controls.AddControl(CustomUserControl, _
        Me.Paragraphs(1).Range, 150, 150, "DynamicControl")

    Dim DynamicControl2 As Microsoft.Office.Tools.Word.ControlSite = _
        Me.Controls.AddControl(CustomUserControl2, _
        200, 0, 150, 150, "DynamicControl2")

    CustomUserControl.BackColor = Color.Blue
    CustomUserControl2.BackColor = Color.Green

    CustomUserControl.Top = 100
    dynamicControl2.Top = 100
End Sub

private void WordRangeAddControl()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    UserControl1 customUserControl = new UserControl1();
    UserControl2 customUserControl2 = new UserControl2();

    Microsoft.Office.Tools.Word.ControlSite dynamicControl =
        this.Controls.AddControl(customUserControl, 
        this.Paragraphs[1].Range, 150, 150, "dynamicControl");

    Microsoft.Office.Tools.Word.ControlSite dynamicControl2 =
        this.Controls.AddControl(customUserControl2, 200, 0,
        150, 150, "dynamicControl2");

    customUserControl.BackColor = Color.Blue;
    customUserControl2.BackColor = Color.Green;

    customUserControl.Top = 100;
    dynamicControl2.Top = 100;
}

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.