ControlExtensions.AddRadioButton Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Aşırı Yüklemeler
| AddRadioButton(ControlCollection, Double, Double, Double, Double, String) |
RadioButtonBelirtilen boyut ve konumdaki çalışma sayfasına yeni bir denetim ekler. |
| AddRadioButton(ControlCollection, Range, String) |
RadioButtonBelirtilen aralıktaki çalışma sayfasına yeni bir denetim ekler. |
AddRadioButton(ControlCollection, Double, Double, Double, Double, String)
RadioButtonBelirtilen boyut ve konumdaki çalışma sayfasına yeni bir denetim ekler.
public static Microsoft.Office.Tools.Excel.Controls.RadioButton AddRadioButton (this Microsoft.Office.Tools.Excel.ControlCollection controls, double left, double top, double width, double height, string name);Parametreler
- controls
- ControlCollection
Denetiminin ekleneceği koleksiyon. Bu parametreyi kendiniz sağlamayın. Bu yöntemi özelliği tarafından döndürülen koleksiyonda Controls (uygulama düzeyi projede) veya Controls özellikte (belge düzeyi projesinde) çağırdığınızda, bu parametre otomatik olarak sağlanır.
- left
- Double
Denetimin sol kenarı ile çalışma sayfasının sol kenarı arasındaki uzaklık.
- top
- Double
Denetimin üst kenarı ile çalışma sayfasının üst kenarı arasındaki uzaklık.
- width
- Double
Nokta cinsinden denetim genişliği.
- height
- Double
Nokta cinsinden denetimin yüksekliği.
- name
- String
Denetimin adı.
Döndürülenler
RadioButtonÖrneğe eklenen denetim ControlCollection .
Özel durumlar
Ad bağımsız değişkeni null sıfır uzunluğa sahip veya bu değeri aştı.
Örnekte aynı ada sahip bir denetim zaten var ControlCollection .
Örnekler
Aşağıdaki kod örneği, RadioButton çalışma sayfasının üst kısmına iki denetim ekler ve sonra her denetime metin atar. Bu örneği kullanmak için, Sheet1 belge düzeyindeki bir projedeki sınıfından çalıştırın.
private void ExcelAddRadioButton()
{
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton1 = this.Controls.AddRadioButton(
0, 0, 78, 18, "radioButton1");
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton2 = this.Controls.AddRadioButton(
0, 18, 78, 18, "radioButton2");
radioButton1.Text = "Bold";
radioButton2.Text = "Italic";
radioButton2.Checked = false;
}
Private Sub ExcelAddRadioButton()
Dim RadioButton1 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(0, 0, 78, 18, "RadioButton1")
Dim RadioButton2 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(0, 18, 78, 18, "RadioButton2")
RadioButton1.Text = "Bold"
RadioButton2.Text = "Italic"
RadioButton2.Checked = False
End Sub
Açıklamalar
AddRadioButtonYöntemi RadioButton , öğesinin sonuna nesne eklemenizi sağlar ControlCollection . RadioButtonDaha önce programlı olarak eklenmiş bir denetimi kaldırmak için Remove yöntemini kullanın.
Birden çok radyo düğmesini doğrudan belgeye eklediğinizde radyo düğmeleri birbirini dışlar. Radyo düğmelerini birbirini dışlamalı hale getirmek için kod yazabilirsiniz; Ancak, tercih edilen yaklaşım, radyo düğmelerini bir kullanıcı denetimine eklemek ve ardından belgeye Kullanıcı denetimini eklemektir.
Şunlara uygulanır
AddRadioButton(ControlCollection, Range, String)
RadioButtonBelirtilen aralıktaki çalışma sayfasına yeni bir denetim ekler.
public static Microsoft.Office.Tools.Excel.Controls.RadioButton AddRadioButton (this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);Parametreler
- controls
- ControlCollection
Denetiminin ekleneceği koleksiyon. Bu parametreyi kendiniz sağlamayın. Bu yöntemi özelliği tarafından döndürülen koleksiyonda Controls (uygulama düzeyi projede) veya Controls özellikte (belge düzeyi projesinde) çağırdığınızda, bu parametre otomatik olarak sağlanır.
- name
- String
Örnekteki denetimin dizinini eklemek için kullanılabilen denetimin adı ControlCollection .
Döndürülenler
RadioButtonÖrneğe eklenen denetim ControlCollection .
Özel durumlar
Ad veya Aralık bağımsız değişkeni null ya da ad bağımsız değişkeninin sıfır uzunluğu vardır.
Örnekte aynı ada sahip bir denetim zaten var ControlCollection .
Belirtilen aralık geçersiz. Çok alanlı aralıklar kullanılamaz. Aralık, örnekle aynı çalışma sayfasında olmalıdır ControlCollection .
Örnekler
Aşağıdaki kod örneği, RadioButton a1 ve a2hücrelerindeki çalışma sayfasına iki denetim ekler ve sonra her denetime metin atar. Bu örneği kullanmak için, Sheet1 belge düzeyindeki bir projedeki sınıfından çalıştırın.
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;
}
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
Açıklamalar
AddRadioButtonYöntemi RadioButton , öğesinin sonuna nesne eklemenizi sağlar ControlCollection . RadioButtonDaha önce programlı olarak eklenen bir öğesini kaldırmak için yöntemini kullanın Remove .
Aralık yeniden boyutlandırılırken denetim otomatik olarak yeniden boyutlandırılır.
Birden çok radyo düğmesini doğrudan belgeye eklediğinizde radyo düğmeleri birbirini dışlar. Radyo düğmelerini birbirini dışlamalı hale getirmek için kod yazabilirsiniz; Ancak, tercih edilen yaklaşım, radyo düğmelerini bir kullanıcı denetimine eklemek ve ardından belgeye Kullanıcı denetimini eklemektir.