Sdílet prostřednictvím

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

  • Článek

Přidá zadaný ovládací prvek ControlCollection v zadaném umístění pomocí 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

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

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

Tato metoda umožňuje přidat libovolný ovládací prvek ControlCollection v době běhu.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů Office za běhu.

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.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 ovládací prvek přesune vzhledem k ControlSite , která obsahuje ovládací prvek v dokumentu.Kód potom nastaví Top vlastnost ControlSite vrácené druhý uživatelský ovládací prvek 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

Viz také

Referenční dokumentace

ControlCollection Rozhraní

AddControl – přetížení

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