Metoda ControlCollection.AddControl — (Control, Range, Single, Single, String)

Artykuł
05/08/2013

Dodaje określony formant do ControlCollection w określonym zakresie, o określonym rozmiarze.

Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestawy: Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)
Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Składnia

'Deklaracja
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
Formant ma zostać dodany do ControlCollection wystąpienie.

range
Typ: Microsoft.Office.Interop.Word.Range
A Range , która zapewnia miejsce dla formantu.

width
Typ: System.Single
Szerokość formantu znajdującego się w punktach.

height
Typ: System.Single
Wysokość formantu znajdującego się w punktach.

name
Typ: System.String
Nazwę, która może być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.

Wartość zwracana

Typ: Microsoft.Office.Tools.Word.ControlSite
Obiekt, który reprezentuje formant zawierający określony formant w dokumencie.

Wyjątki

Wyjątek	Warunek
ArgumentNullException	name, Lub range argument jest nullodwołanie o wartości null (Nothing w języku Visual Basic), lub name argument ma zerową długość.
ControlNameAlreadyExistsException	Formant o tej samej nazwie jest już pod ControlCollection wystąpienie.
ControlCouldNotBeInitializedException	The control argument is nullodwołanie o wartości null (Nothing w języku Visual Basic).

Uwagi

Ta metoda może służyć do dodawania w formancie ControlCollection w czasie wykonywania.Aby uzyskać więcej informacji, zobacz Dodawanie formantów do dokumentów pakietu Office w czasie wykonywania.

Przykłady

Poniższy przykład kodu dodaje dwa formanty użytkownika niestandardowego do dokumentu przy pomocy AddControl metoda.Pierwszy formant jest dodawany do Range.Drugi formant jest dodawany do określonej lokalizacji.Zmiany w kodzie Top właściwość pierwszego formantu użytkownika niestandardowego, który przenosi tylko formant stosunku do ControlSite który zawiera formant w dokumencie.Kod następnie ustawia Top właściwość ControlSite zwrócone przez drugi formant użytkownika, aby zilustrować prawidłowy sposób, aby ustawić Top właściwości formantu.

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;
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..