ControlCollection.AddControl 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
| AddControl(Control, Range, String) |
Belirtilen Control aralıktaki öğesine belirtilen öğesine ekler ControlCollection . |
| AddControl(Control, Double, Double, Double, Double, String) |
Belirtilen Control ControlCollection konumu ve boyutunu belirtilen konumuna ekler. |
AddControl(Control, Range, String)
Belirtilen Control aralıktaki öğesine belirtilen öğesine ekler ControlCollection .
public Microsoft.Office.Tools.Excel.ControlSite AddControl (System.Windows.Forms.Control control, Microsoft.Office.Interop.Excel.Range range, string name);Parametreler
- control
- Control
Örneğe eklenecek denetim ControlCollection .
- name
- String
Örnekteki denetimin dizinini eklemek için kullanılabilen denetimin adı ControlCollection .
Döndürülenler
Çalışma sayfasında belirtilen denetimi içeren denetimi temsil eden nesne.
Özel durumlar
Denetim, 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, yöntemi kullanılarak çalışma sayfasına iki özel kullanıcı denetimi ekler AddControl . İlk denetim bir hücre aralığına eklenir. İkinci denetim belirli bir konuma eklenir. Kod, Top ilk özel kullanıcı denetiminin özelliğini değiştirir ve bu, denetimi yalnızca ControlSite çalışma sayfasındaki denetimi içeren öğesine göre kaydırır. Daha sonra kod, Top ControlSite denetimin özelliğini ayarlamak için doğru yolu göstermek üzere ikinci Kullanıcı denetimi tarafından döndürülen özelliğini ayarlar Top .
private void ExcelRangeAddControl()
{
UserControl1 customUserControl = new UserControl1();
UserControl2 customUserControl2 = new UserControl2();
Microsoft.Office.Tools.Excel.ControlSite dynamicControl =
this.Controls.AddControl(customUserControl,
0, 0, 150, 150, "dynamicControl");
Microsoft.Office.Tools.Excel.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;
}
Private Sub ExcelRangeAddControl()
Dim CustomUserControl As New UserControl1()
Dim CustomUserControl2 As New UserControl2()
Dim DynamicControl As Microsoft.Office.Tools.Excel.ListObject = Me.Controls.AddControl( _
CustomUserControl, 0, 0, 150, 150, _
"DynamicControl")
Dim DynamicControl2 As Microsoft.Office.Tools.Excel. _
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
Açıklamalar
Bu yöntem, çalışma zamanında bir denetim eklemek için kullanılabilir ControlCollection . Daha fazla bilgi için bkz. çalışma zamanında Office belgelerine denetim ekleme.
Şunlara uygulanır
AddControl(Control, Double, Double, Double, Double, String)
Belirtilen Control ControlCollection konumu ve boyutunu belirtilen konumuna ekler.
public Microsoft.Office.Tools.Excel.ControlSite AddControl (System.Windows.Forms.Control control, double left, double top, double width, double height, string name);Parametreler
- control
- Control
Örneğe eklenecek denetim ControlCollection .
- 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
Çalışma sayfasında belirtilen denetimi içeren denetimi temsil eden nesne.
Özel durumlar
Denetim veya ad bağımsız değişkeni null sıfır uzunlukta.
Örnekte aynı ada sahip bir denetim zaten var ControlCollection .
Örnekler
Aşağıdaki kod örneği, yöntemi kullanılarak çalışma sayfasına iki özel kullanıcı denetimi ekler AddControl . İlk denetim bir hücre aralığına eklenir. İkinci denetim belirli bir konuma eklenir. Kod, Top ilk özel kullanıcı denetiminin özelliğini değiştirir ve bu, denetimi yalnızca ControlSite çalışma sayfasındaki denetimi içeren öğesine göre kaydırır. Daha sonra kod, Top ControlSite denetimin özelliğini ayarlamak için doğru yolu göstermek üzere ikinci Kullanıcı denetimi tarafından döndürülen özelliğini ayarlar Top .
private void ExcelRangeAddControl()
{
UserControl1 customUserControl = new UserControl1();
UserControl2 customUserControl2 = new UserControl2();
Microsoft.Office.Tools.Excel.ControlSite dynamicControl =
this.Controls.AddControl(customUserControl,
0, 0, 150, 150, "dynamicControl");
Microsoft.Office.Tools.Excel.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;
}
Private Sub ExcelRangeAddControl()
Dim CustomUserControl As New UserControl1()
Dim CustomUserControl2 As New UserControl2()
Dim DynamicControl As Microsoft.Office.Tools.Excel.ListObject = Me.Controls.AddControl( _
CustomUserControl, 0, 0, 150, 150, _
"DynamicControl")
Dim DynamicControl2 As Microsoft.Office.Tools.Excel. _
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
Açıklamalar
Bu yöntem, çalışma zamanında bir denetim eklemek için kullanılabilir ControlCollection . Daha fazla bilgi için bkz. çalışma zamanında Office belgelerine denetim ekleme.