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

Makale
02/17/2014

Belirtilen denetime ekler ControlCollection belirlenen aralıkta 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, _
    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
)

Parametreler

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

range
Tür: Microsoft.Office.Interop.Word.Range
A Range , denetim için bir konum sağlar.

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

height
Tür: System.Single
Nokta cinsinden denetimin yüksekliği.

name
Tür: System.String
Denetimde dizini oluşturmak için kullanılan adı ControlCollection örneğ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, Veya range 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

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 Koddan Kitaplıkları Kullanma.