ControlExtensions.AddRadioButton Yöntem (ControlCollection, Range, String)
Yeni bir ekler RadioButton belirtilen aralık çalışma sayfası denetimi.
Ad alanı: Microsoft.Office.Tools.Excel
Derleme: Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll içinde)
Sözdizimi
'Bildirim
<ExtensionAttribute> _
Public Shared Function AddRadioButton ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As RadioButton
public static RadioButton AddRadioButton(
this ControlCollection controls,
Range range,
string name
)
Parametreler
- controls
Tür: Microsoft.Office.Tools.Excel.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 Worksheet.Controls (uygulama düzeyinde projedeki) özelliği veya WorksheetBase.Controls özelliği (bir belge düzeyinde projesinde), bu parametre otomatik olarak sağlanır.
- range
Tür: Microsoft.Office.Interop.Excel.Range
A Range , sınırları için bir denetim sağlar.
- name
Tür: System.String
Denetimde dizin oluşturmak için kullanılan denetimin adını ControlCollection örneği.
Dönüş Değeri
Tür: Microsoft.Office.Tools.Excel.Controls.RadioButton
RadioButton Eklenmiştir Denetim ControlCollection örneği.
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 | Ad veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing), ya da name bağımsız değişkeni sıfır uzunlukta. |
ControlNameAlreadyExistsException | Aynı ada sahip bir denetim içinde ControlCollection örneği. |
InvalidRangeException | Belirtilen aralık geçerli değil.Multi-Area aralıkları kullanılamaz.Aralığı aynı çalışma sayfasında olması gereken ControlCollection örneği. |
Notlar
AddRadioButton Yöntemi eklemenize olanak sağlayan RadioButton sonuna kadar nesne ControlCollection.Kaldırmak için bir RadioButton , daha önce eklenmiştir programlı olarak, kullanmak Remove yöntemi.
Aralığı yeniden boyutlandırıldığında denetimi otomatik olarak yeniden boyutlandırır.
Belgeye birden çok radyo düğmesini doğrudan eklediğinizde, radyo düğmeleri ayrı ayrı çalışmaz.Radyo düğmelerini ayrı ayrı çalışır yapmak için kod yazabilirsiniz; ama tercih edilen yaklaşım, radyo düğmelerini kullanıcı denetimine ekleyip sonra da belgeye eklemektir.
Örnekler
Aşağıdaki kod örneği, iki ekler RadioButton çalışma sayfasında hücreleri, denetimleri A1 ve A2ve ardından her bir denetimin metin atar.Çalıştır buradan bu örneği kullanmak için Sheet1 bir belge düzeyinde proje sınıfında.
Private Sub ExcelRangeAddRadioButton()
Dim RadioButton1 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(Me.Range("A1"), "RadioButton1")
Dim RadioButton2 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(Me.Range("A2"), "RadioButton2")
RadioButton1.Text = "Bold"
RadioButton2.Text = "Italic"
RadioButton2.Checked = False
End Sub
private void ExcelRangeAddRadioButton()
{
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton1 = this.Controls.AddRadioButton(
this.Range["A1"], "radioButton1");
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton2 = this.Controls.AddRadioButton(
this.Range["A2"], "radioButton2");
radioButton1.Text = "Bold";
radioButton2.Text = "Italic";
radioButton2.Checked = false;
}
.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.