العمل مع OLE الكائنات

OLE (ربط الكائنات وتضمينها) هي تقنية يمكن للمستخدمين من خلالها العمل مع المستندات التي تحتوي على “كائنات” تم إنشاؤها أو تحريرها بواسطة تطبيقات الطرف الثالث. أي أن OLE يسمح لتطبيق التحرير بتصدير هذه “الكائنات” إلى تطبيق تحرير آخر ثم استيرادها بمحتوى إضافي.

في هذه المقالة، سنتحدث عن إدراج كائن OLE وتعيين خصائصه في مستند.

إدراج OLE كائن

إذا كنت تريد OLE كائن، استدعاء طريقة InsertOleObject وتمريرها ProgId صراحة مع غيرها من المعالم.

يوضح مثال التعليمات البرمجية التالية كيفية إدراج كائن OLE في مستند:

تعيين اسم الملف والامتداد عند إدراج OLE كائن

حزمة OLE هي طريقة قديمة و" غير موثقة " لتخزين الكائنات المضمنة إذا كان معالج OLE غير معروف.

كانت الإصدارات المبكرة Windows مثل Windows 3.1 و 95 و 98 تحتوي على حزمة.تطبيق إكس التي يمكن استخدامها لتضمين أي نوع من البيانات في المستند. تم استبعاد هذا التطبيق الآن من Windows، ولكن Microsoft Word والتطبيقات الأخرى لا تزال تستخدمه لتضمين البيانات إذا كان معالج OLE مفقودا أو غير معروف. تتيح فئة OlePackage للمستخدمين الوصول إلى خصائص حزمة OLE.

يوضح مثال التعليمات البرمجية التالية كيفية تعيين اسم الملف والملحق واسم العرض لحزمة OLE:

الحصول على OLE كائن البيانات الخام

يمكن للمستخدمين الوصول إلى OLE بيانات الكائن باستخدام خصائص وطرق مختلفة لفئة OleFormat. على سبيل المثال، من الممكن الحصول على البيانات الأولية للكائن OLE أو مسار واسم الملف المصدر للكائن OLE المرتبط.

يوضح مثال التعليمات البرمجية التالية كيفية الحصول على OLE كائن البيانات الخام باستخدام طريقة GetRawData:

إدراج كائن أولي كرمز

OLE يمكن أيضا إدراج الكائنات في المستندات كصور.

يوضح مثال الكود التالي كيفية إدراج كائن OLE كرمز. لهذا الغرض، تعرض فئة DocumentBuilder طريقة InsertOleObjectAsIcon:

يوضح مثال التعليمات البرمجية التالية كيفية إدراج كائن OLE مضمن كرمز من دفق في المستند:

إدراج الفيديو على الانترنت

يمكن إدراج الفيديو عبر الإنترنت في مستند ورد من علامة التبويب “Insert” > “Online Video”. يمكنك إدراج مقطع فيديو عبر الإنترنت في مستند في الموقع الحالي عن طريق استدعاء طريقة InsertOnlineVideo.

ال DocumentBuilder تقدم الفئة أربعة أحمال زائدة من هذه الطريقة. أول واحد يعمل مع موارد الفيديو الأكثر شعبية ويأخذ URL من الفيديو كمعلمة. على سبيل المثال، يدعم الحمل الزائد الأول الإدراج البسيط لمقاطع الفيديو عبر الإنترنت من YouTube و فيميو الموارد.

يوضح مثال الكود التالي كيفية إدراج مقطع فيديو عبر الإنترنت من Vimeo في مستند:

يعمل الحمل الزائد الثاني مع جميع موارد الفيديو الأخرى ويأخذ رمز HTML مضمن كمعلمة. قد يختلف رمز HTML لتضمين مقطع فيديو اعتمادا على الموفر، لذا اتصل بالموفر المعني للحصول على التفاصيل.

يوضح مثال الكود التالي كيفية إدراج مقطع فيديو عبر الإنترنت في مستند باستخدام رمز HTML هذا: