العمل مع 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 هذا: