Aracılığıyla paylaş

ControlCollection.AddControl Yöntem (Control, Single, Single, Single, Single, String)

  • Makale

Belirtilen denetime ekler ControlCollection belirtilen konumda belirtilen boyutta.

Ad alanı:  Microsoft.Office.Tools.Word
Derlemeler:   Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll içinde)
  Microsoft.Office.Tools.Word.v4.0.Utilities (Microsoft.Office.Tools.Word.v4.0.Utilities.dll içinde)

Sözdizimi

'Bildirim
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
)

Parametreler

  • left
    Tür: System.Single
    Nokta belgenin sol kenarında denetimin sol kenarı arasındaki uzaklık.
  • top
    Tür: System.Single
    Nokta denetimin üst kenarı ve belgenin üst kenarı arasındaki uzaklık.
  • width
    Tür: System.Single
    Nokta cinsinden denetimin genişliği.
  • height
    Tür: System.Single
    Nokta cinsinden denetimin yüksekliği.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Word.ControlSite
Belgede belirtilen Denetim içeren denetimi temsil eden nesne.

Özel Durumlar

Exception Koşul
ArgumentNullException

name Bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing), veya name uzunluğu sıfır bağımsız değişkene sahiptir.
ControlNameAlreadyExistsException

Aynı ada sahip bir denetim zaten kullanılıyor ControlCollection örneği.
ControlCouldNotBeInitializedException

The control argument is nullnull başvuru (Visual Basic'te Nothing).

Notlar

Bu yöntem, herhangi bir denetimi eklemek için kullanılabilir ControlCollection zamanında.Daha fazla bilgi için bkz. Office Belgelerine Çalışma Zamanında Denetim Ekleme.

Örnekler

Aşağıdaki kod örneği kullanarak belgenin iki özel kullanıcı denetimleri ekler AddControl yöntem.İlk denetim eklenir bir Range.İkinci denetimi belirli bir konuma eklenir.Kod değişiklikleri Top özelliği yalnızca denetimi taşır ilk özel kullanıcı denetiminin göreli olarak ControlSite , belgedeki denetimi içerir.Kod daha sonra ayarlar Top özelliği ControlSite en doğru yolu göstermek için ikinci kullanıcı denetimi tarafından döndürülen Top denetiminin özelliği.

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

.NET Framework Güvenliği

Ayrıca bkz.

Başvuru

ControlCollection Arabirim

AddControl Fazla Yük

Microsoft.Office.Tools.Word Ad Alanı