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

Makale
10/29/2012

Belirtilen denetim ekler ControlCollection belirtilen konumda belirtilen boyutta.

Ad alanı: Microsoft.Office.Tools.Word
Derleme: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.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

control
Tür: System.Windows.Forms.Control
Eklenecek Denetim ControlCollection örneği.

left
Tür: System.Single
Nokta belgenin sol kenarında denetimin sol kenarı arasındaki uzaklık.

top
Tür: System.Single
Nokta denetim üst kenarını belgenin üst kenarı arasındaki uzaklık.

width
Tür: System.Single
Puan denetimin genişliği.

height
Tür: System.Single
Denetim noktalarını yüksekliği.

name
Tür: System.String
Denetimin adı.

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 içinde ControlCollection örneği.
ControlCouldNotBeInitializedException	The control argument is nullnull başvuru (Visual Basic'te Nothing).

Notlar

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

Örnekler

Aşağıdaki kod örneği, belge kullanma iki özel kullanıcı denetimleri ekler AddControl yöntemi.İlk denetim için eklenen bir Range.İkinci denetimin 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 , belge 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

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. Kısmen güvenilen kod kitaplıklarını kullanma.

Ayrıca bkz.

Başvuru

ControlCollection Arabirim

AddControl Fazla Yük

Microsoft.Office.Tools.Word Ad Alanı

Aracılığıyla paylaş