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

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
  Kontroli, które mają zostać dodane do ControlCollection wystąpienie.

• range
  Typ: Microsoft.Office.Interop.Word.Range
  A Range , udostępniająca miejsce do celów kontroli.

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

• height
  Typ: System.Single
  Wysokość formantu w punktach.

• name
  Typ: System.String
  Nazwy, które mogą 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ż w 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 dowolnego formantu do 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 kod dodaje dwa formanty użytkownika niestandardowego do dokumentu za pomocą AddControl metody.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 porusza się tylko formantu względem ControlSite zawierający formant w dokumencie.Następnie ustawia kod Top właściwość ControlSite zwrócone przez drugi formant użytkownika do zilustrowania w prawidłowy sposób, aby ustawić Top właściwość 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 Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

ControlCollection Interfejs

Przeciążenie AddControl

Przestrzeń nazw Microsoft.Office.Tools.Word