الوصول العمومي إلى الكائنات في مشاريع Office
ينطبق على |
|---|
|
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع
إصدار Microsoft Office
|
عند إنشائك لمشروع Office، يقوم Visual Studio تلقائياً بإنشاء فئة باسم Globals في المشروع. يمكنك استخدام فئة Globals للوصول إلى عناصر متعددة مختلفة للمشروع في وقت التشغيل من أي تعليمة برمجية في المشروع.
كيفية استخدام الفئة العمومية
Globals عبارة عن فئة ثابتة تحتفظ بمراجع لعناصر معينة في المشروع. باستخدام الفئة Globals، يمكنك الوصول إلى العناصر التالية من أي تعليمة برمجية في المشروع في وقت التشغيل:
Workbook أو أي عنصر مضيف Worksheet في مصنف Excel أو مشروع القالب. يمكنك الوصول إلى عناصر المضيف هذه وذلك باستخدام خصائص الفئة Globals التي تشير لكل عنصر مضيف في المشروع الخاص بك. بشكل افتراضي، أسماء العنصر المضيف هي ThisWorkbook و Sheet1 و Sheet2 و Sheet3.
العنصر المضيف Document في مستند Word أو مشروع القالب. يمكنك الوصول إلى العنصر المضيف هذا باستخدام خاصية ThisDocument الخاصة بالفئة Globals.
العنصر المضيف AddIn في مشروع علي مستوي التطبيق. يمكنك الوصول إلى العنصر المضيف هذا باستخدام خاصية ThisAddIn الخاصة بالفئة Globals.
كافة الأشرطة في المشروع الخاص بك التي قمت بتخصيصها باستخدام مصمم الشريط. يمكن الوصول إلى الأشرطة باستخدام خاصية Ribbons للفئة Globals. لمزيد من المعلومات، راجع الوصول إلى الشريط في وقت التشغيل.
كافة مناطق نموذج Outlook في مشروع وظيفة Outlook الإضافية. يمكنك الوصول إلى مناطق النموذج هذه باستخدام خاصية FormRegions للفئة Globals. لمزيد من المعلومات، راجع الوصول إلى منطقة نموذج في وقت التشغيل.
كائن المصنع الذي يتيح لك إنشاء عنصر تحكم الشريط و التبويب الذكي و عناصر المضيف في وقت التشغيل. هذا الكائن هو مثيل للفئة التي تطبّق أحد الواجهات التالية:
يمكنك الوصول إلى هذا الكائن باستخدام خاصية Factory للفئة Globals.
ملاحظة
خاصية Factory متوفرة فقط للمشاريع التي تستهدف .NET Framework 4.
على سبيل المثال، يمكنك استخدام خاصية Globals.Sheet1 لإدراج نص في عنصر تحكم NamedRange على Sheet1 عند قيام مستخدم بالنقر فوق زر في جزء الإجراءات في مشروع علي مستوى المستند لـ Excel.
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
Handles Button1.Click
If Globals.Sheet1 IsNot Nothing Then
Globals.Sheet1.NamedRange1.Value2 = Me.TextBox1.Text
End If
End Sub
private void button1_Click(object sender, EventArgs e)
{
if (Globals.Sheet1 != null)
{
Globals.Sheet1.namedRange1.Value2 = this.textBox1.Text;
}
}
تهيئة الفئة Globals
التعليمة البرمجية التي تحاول استخدام الفئة Globals قبل تهيئة المستند أو الوظيفة الإضافية بالكامل قد تقوم برفع استثناء في وقت التشغيل. على سبيل المثال، استخدام Globals عند التصريح بمتغير علي مستوي الفئة قد يفشل لأن الفئة Globals قد لا يمكن تهيئتها مع مراجع إلى كافة عناصر المضيف قبل إنشاء مثيل للكائن المعرّف.
ملاحظة
الفئة Globals لا يتم تهيئتها أبداً في وقت التصميم لكن يتم إنشاء مثيلات لعنصر التحكم بواسطة المصمم. وهذا يعني أنه إذا قمت بإنشاء عنصر تحكم يقوم باستدعاء أساليب الفئة Globals، يجب عليك كتابة تعليمة برمجية تتحقق مما إذا كان الأسلوب يقوم بإرجاع null قبل محاولة الوصول إليه.
راجع أيضًا:
المبادئ
الوصول إلى الشريط في وقت التشغيل
الوصول إلى منطقة نموذج في وقت التشغيل