دالة GetObject (JScript 8.0)
إرجاع a مرجع إلى an Automation كائن من a ملف. يوجد نموذجان للدالة.
function GetObject(class : String)
function GetObject(pathname : String [, class : String])
الوسيطات
class
مطلوبة. سلسلة من النموذج "appName . objectType " الموقع appName هو اسم تطبيق يوفر الكائن وهو objectType النوع أو فئة كائن إلى إنشاء.اسم المسار
مطلوبة. مسار الكامل واسم الملف الذي يحتوي على الكائن المراد استردادها. إذا كان اسم مسار هو حذفها، classهو المطلوبة.
ملاحظات
استخدام GetObjectالدالة للوصول إلى كائن "التنفيذ تلقائي" من ملف. قم بتعيين كائن تم إرجاعه بواسطة GetObjectإلى متغير الكائن. فعلى سبيل المثال:
var CADObject;
CADObject = GetObject("C:\\CAD\\SCHEMA.CAD");
عند تنفيذ هذه تعليمات برمجية، يتم تشغيل تطبيق المقترن مع pathname المحدد ، والكائن في الفرعي ملف تنشيط. إذا كان اسم مسار هو سلسلة ذات الطول صفري ("")، GetObjectإرجاع مثيل كائن جديد من النوع المحدد. إذا كانت وسيطة pathname هو حذفها، GetObjectإرجاع كائن نشط حاليا من النوع المحدد. إذا لا يوجد كائن النوع المحدد، يحدث خطأ.
تسمح بعض التطبيقات إلى تنشيط جزء من ملف. للقيام بذلك، قم بإضافة علامة تعجب نقطة (!) إلى الإنهاء ملف تسمية وتتبعه بسلسلة تعريف الجزء ملف الذي تريد تنشيطه. للحصول تشغيل معلومات حول إلى تاريخ الإنشاء هذه السلسلة، راجع وثائق تطبيق الذي أنشأ الكائن.
على سبيل المثال، في تطبيق رسم قد يكون لديك عدة طبقات إلى sإلىred رسم في ملف. يمكنك استخدام الخيارات التالية تعليمات برمجية لتنشيط طبقة ضمن رسم يسمى SCHEMA.CAD:
var LayerObject = GetObject("C:\\CAD\\SCHEMA.CAD!Layer3");
إذا لم don لك بتعيين الفئة للكائن، التنفيذ التلقائي تحديد تطبيق الذي بدء والكائن الذي لتنشيط، استناداً إلى ملف قمت بتوفير اسم. بعض الملفات، على الرغم من ذلك، قد دعم المزيد فئة الكائن. ل مثال، قد تعتمد رسم ثلاثة أنواع مختلفة من الكائنات: كائن تطبيق، كائن رسم، و كائن شريط أدوات، وكافة الأشياء التي تعد جزءا من نفس الملف. إلى تحديد أي كائن في ملف إلى التنشيط، استخدم الزر الاختياري classوسيطة. فعلى سبيل المثال:
var MyObject;
MyObject = GetObject("C:\\DRAWINGS\\SAMPLE.DRW", "FIGMENT.DRAWING");
في المثال السابق، FIGMENTهو اسم تطبيق الرسم و DRAWINGواحد كائن أنواع أنه يدعم. كائن مرة واحدة هو تنشيط، مرجع له في تعليمات برمجية باستخدام متغير الكائن الذي تعرفه. في المثال السابق، يمكنك الوصول إلى الخصائص والأساليب الخاصة الجديدة كائن استخدام كائن المتغير MyObject. فعلى سبيل المثال:
MyObject.Line(9, 90);
MyObject.InsertText(9, 100, "Hello, world.");
MyObject.SaveAs("C:\\DRAWINGS\\SAMPLE.DRW");
ملاحظة
استخدام GetObjectالدالة عند وجود هو مثيل الحالي للكائن، أو إذا كنت ترغب في إنشاء الكائن مع ملف مسبقاً تم تحميله. إذا كان هناك هو المثيل الحالي لا يوجد، وأنت لا تريد الكائن بدأت بتحميل ملف، استخدم ActiveXObjectالكائن.
إذا كان كائن regهوtered نفسه ككائن مثيل مفرد، مثيل مفرد فقط للكائن هو التي تم إنشاؤها، بغض النظر عن عدد المرات ActiveXObjectهو تنفيذها. مع كائن مثيل واحد، GetObjectدوماً بإرجاع نفس المثيل عند استدعائه بالسلسلة ذات الطول الصفري ("") بناء الجملة، ويؤدي إلى خطأ إذا كان وسيطة pathname هو مهمل.