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

Článek
05/14/2013

Přidá zadaný ovládací prvek ControlCollection na zadaný rozsah se zadanou velikostí.

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, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As ControlSite

ControlSite AddControl(
    Control control,
    Range range,
    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.

range
Typ: Microsoft.Office.Interop.Word.Range
A Range , který poskytuje umístění ovládacího prvku.

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, který lze použít k indexování ovládacího prvku v ControlCollection instance.

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, 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ž 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.