ControlExtensions.AddCheckedListBox Yöntem (ControlCollection, Range, Single, Single, String)

Makale
02/17/2014

Yeni bir ekler CheckedListBox denetlemek için belge içinde belirtilen boyut ve konumu.

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 AddCheckedListBox ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As CheckedListBox

public static CheckedListBox AddCheckedListBox(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

Parametreler

controls
Tür: Microsoft.Office.Tools.Word.ControlCollection
Denetimine eklemek için koleksiyon.Bu parametre, kendinizi sağlamaz.Tarafından döndürülen koleksiyon üzerinde bu yöntemi çağırdığınızda Document.Controls özelliği (uygulama düzeyi projesinde) veya DocumentBase.Controls özellik (bir belge düzeyi projesinde), bu parametre otomatik olarak verilir.

range
Tür: Microsoft.Office.Interop.Word.Range
Denetim dosyasının konumu.

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.Controls.CheckedListBox
Belgeye eklenmiş olan denetim.

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öntemleri (Visual Basic) veya Genişletme Yöntemleri (C# Programlama Kılavuzu).

Ö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.
InvalidRangeException	Belirtilen aralık geçersiz.

Notlar

Bu yöntem eklemenize olanak sağlayan CheckedListBox nesneleri sonuna kadar ControlCollection.

Kaldırmak için bir CheckedListBox programlı olarak eklenen, kullanın Remove yöntem.

Örnekler

Aşağıdaki kod örneği ekler bir CheckedListBox denetimini belgenizdeki ilk paragrafa, iki madde işaretli liste kutusuna ekler ve ardından seçer İlk madde onay kutusu.Bu örneği kullanmak için çalıştırın ThisDocument bir belge düzeyi projesinde sınıf.

Private Sub WordRangeAddCheckedListBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim CheckedListBox1 As Microsoft.Office.Tools.Word. _
        Controls.CheckedListBox = Me.Controls.AddCheckedListBox( _
        Me.Paragraphs(1).Range, 90, 66.75F, "CheckedListBox1")
    CheckedListBox1.Items.Add("First Item")
    CheckedListBox1.Items.Add("Second Item")
    CheckedListBox1.SetItemChecked(0, True)
End Sub

private void WordRangeAddCheckedListBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.CheckedListBox 
        checkedListBox1 = this.Controls.AddCheckedListBox(
        this.Paragraphs[1].Range, 90, 66.75F, "checkedListBox1");
    checkedListBox1.Items.Add("First Item");
    checkedListBox1.Items.Add("Second Item");
    checkedListBox1.SetItemChecked(0, true);
}

.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.

Ayrıca bkz.

Başvuru

ControlExtensions Sınıf

AddCheckedListBox Fazla Yük

Microsoft.Office.Tools.Word Ad Alanı

Aracılığıyla paylaş