ControlCollection.AddControl أسلوب (Control, Single, Single, Single, Single, String)
يضيف الفرعي عنصر تحكم إلى ControlCollectionفي الموقع المحدد، مع الحجم المحدد.
مساحة الاسم: Microsoft.Office.Tools.Word
التجميع: Microsoft.Office.Tools.Word (في Microsoft.Office.Tools.Word.dll)
بناء الجملة
'إقرار
Function AddControl ( _
control As Control, _
left As Single, _
top As Single, _
width As Single, _
height As Single, _
name As String _
) As ControlSite
ControlSite AddControl(
Control control,
float left,
float top,
float width,
float height,
string name
)
المعلمات
- control
النوع: System.Windows.Forms.Control
عنصر تحكم المراد إضافتها إلى ControlCollectionالمثيل.
- left
النوع: System.Single
المسافة بالنقاط بين الحافة اليمنى عنصر تحكم والحافة اليسرى للمستند.
- top
النوع: System.Single
المسافة بالنقاط بين الحافة العلوية من عنصر تحكم والحافة العليا من مستند.
- width
النوع: System.Single
العرض عنصر تحكم بالنقاط.
- height
النوع: System.Single
الارتفاع عنصر تحكم بالنقاط.
- name
النوع: System.String
الاسم عنصر تحكم.
القيمة المُرجعة
النوع: Microsoft.Office.Tools.Word.ControlSite
كائن الذي يمثل عنصر تحكم الذي يتضمن الفرعي عنصر تحكم تشغيل مستند.
استثناءات
استثناء: | شرط |
---|---|
ArgumentNullException | controlأو nameهو وسيطة nullمرجع خالٍ (لا شيء في Visual Basic)، أو nameعلى وسيطة صفر الطول. |
ControlNameAlreadyExistsException | عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل. |
ملاحظات
يمكن استخدام هذا الأسلوب إلى إضافة أي عنصر تحكم إلى ControlCollectionفي وقت التشغيل. لمزيد من المعلومات، راجع إضافة عناصر إلى مستندات Office في وقت التشغيل.
أمثلة
مثال التعليمة البرمجية التالية يضيف اثنين مخصص عناصر تحكم مستخدم للمستند باستخدام AddControlالأسلوب. أول عنصر تحكم يضاف إلى Range. عنصر التحكم الثاني هو تمت الإضافة إلى الموقع محدد. تغيير تعليمات برمجية Topالخاصية للمستخدم أول مخصص عنصر تحكم، الانتقال الوحيدة التي عنصر تحكم نسبة إلى ControlSiteالذي يحتوي تشغيل عنصر تحكم تشغيل مستند. تعليمات برمجية ثم تعيين Topخاصية ControlSiteيتم إرجاعها بواسطة عنصر تحكم مستخدم الثاني إلى توضيح الطريقة الصحيحة إلى تعيين Topالخاصية لعنصر التحكم.
Private Sub WordRangeAddControl()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim CustomUserControl As New UserControl1()
Dim CustomUserControl2 As New UserControl2()
Dim DynamicControl As Microsoft.Office.Tools.Word.ControlSite = _
Me.Controls.AddControl(CustomUserControl, _
Me.Paragraphs(1).Range, 150, 150, "DynamicControl")
Dim DynamicControl2 As Microsoft.Office.Tools.Word.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
private void WordRangeAddControl()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
UserControl1 customUserControl = new UserControl1();
UserControl2 customUserControl2 = new UserControl2();
Microsoft.Office.Tools.Word.ControlSite dynamicControl =
this.Controls.AddControl(customUserControl,
this.Paragraphs[1].Range, 150, 150, "dynamicControl");
Microsoft.Office.Tools.Word.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;
}
أمن NET Framework.
- الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.