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

Článek
08/11/2011

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)

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
Přidat do ovládacího prvku ControlCollection instance.

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

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

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 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	control Nebo 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ž v ControlCollection instance.

Poznámky

Tuto metodu lze použít libovolný ovládací prvek přidat ControlCollection v čase zpracování. Další informace naleznete v tématu Adding Controls to Office Documents at Run Time.

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 metody. Vkládá na první ovládací prvek Range. Druhý ovládací prvek je přidán na určité místo. Kód změní Top vlastnost první vlastní uživatel řízení, které pouze přesune ovládací prvek vzhledem k ControlSite , která obsahuje ovládací prvek v dokumentu. Kód poté nastaví Top Vlastnosti ControlSite vrátil druhý ovládací prvek uživatele ilustrují správné lze 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.