ControlExtensions.AddButton Yöntem (ControlCollection, Single, Single, Single, Single, String)

Makale
08/01/2011

Yeni bir ekler Button denetlemek için belgede belirtilen boyut ve konum.

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

Sözdizimi

'Bildirim
<ExtensionAttribute> _
Public Shared Function AddButton ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As Button

public static Button AddButton(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)

Parametreler

controls
Tür: Microsoft.Office.Tools.Word.ControlCollection
Denetim eklemek için koleksiyon.Bu parametre kendinizin saðlamasý değil.Tarafından döndürülen koleksiyonu bu yöntem aradığınızda Document.Controls (uygulama düzeyinde projedeki) özelliği veya DocumentBase.Controls özelliği (bir belge düzeyinde projesinde), bu parametre otomatik olarak sağlanan.

left
Tür: System.Single
Nokta denetiminin sol kenarına belgenin 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ı içinde yüksekliği.

name
Tür: System.String
Denetimde dizin oluşturmak için kullanılan adı ControlCollection örneği.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Word.Controls.Button
Belgeye eklenmiş olan denetimdir.

Kullanım Notu

Visual Basic ve C# programlarında, bu yöntemi ControlCollection türündeki herhangi bir nesne üzerinde örnek yöntemi olarak çağırabilirsiniz. Bu yöntemi çağırmak için örnek yöntemi sözdizimini kullandığınızda, ilk parametreyi yok sayın. Daha fazla bilgi için bkz. Uzantı Yöntemler (@) veya Uzantı Yöntemler (C# programlama Kılavuzu).

Özel Durumlar

Exception	Koşul
ArgumentNullException	name Bağımsız değişkeni nullnull başvuru (Visual Basic\'te Nothing) veya sıfır uzunluk.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim söz ControlCollection örneği.

Açıklamalar

Bu yöntem eklemenize olanak tanır Button sonuna kadar nesneleri ControlCollection.

Kaldırmak için bir Button , eklenmiştir programlı, kullanın Remove yöntemi.

Örnekler

Aşağıdaki kod örneği ekler bir Button , belgenin başlangıcına kontrol ve ekler metin düğmesi. Bu örneği kullanmak için çalıştırın buradan ThisDocument sınıfında bir belge düzeyinde proje.

Private Sub WordAddButton()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim button1 As Microsoft.Office.Tools.Word.Controls.Button _
        = Me.Controls.AddButton(0, 0, 56.25F, 17.25F, "Button1")
    button1.Text = "OK"
End Sub

private void WordAddButton()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25F, 17.25F,
        "button1");
    button1.Text = "OK";
}

.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üvenilir kod tarafından Kitaplıklar kullanma.

Ayrıca bkz.

Başvuru

ControlExtensions Sınıf

AddButton Fazla Yük

Microsoft.Office.Tools.Word Ad Alanı

Aracılığıyla paylaş