Udostępnij za pośrednictwem

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

  • Artykuł

Dodaje określony formant do ControlCollection w określonej lokalizacji, z 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.
  • height
    Typ: System.Single
    Wysokość 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ż 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

Zobacz też

Informacje

ControlCollection Interfejs

Przeciążenie AddControl

Przestrzeń nazw Microsoft.Office.Tools.Word