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

  • Artykuł

Dodaje określony formant do ControlCollection w określonej lokalizacji, 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, _
    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
    Odległość w punktach między lewą krawędzią formantu a lewą krawędzią dokumentu.
  • top
    Typ: System.Single
    Odległość w punktach między górną krawędzią formantu a górną krawędzią dokumentu.
  • width
    Typ: System.Single
    Szerokość formantu znajdującego się w punktach.

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

Zobacz też

Informacje

ControlCollection Interfejs

Przeciążenie AddControl

Przestrzeń nazw Microsoft.Office.Tools.Word