کار با اشیاء OLE

OLE (پیوند و جاسازی اشیاء) یک تکنولوژی است که کاربران می توانند با اسناد حاوی “اشیاء” که توسط برنامه های شخص ثالث ایجاد یا ویرایش شده اند کار کنند. یعنی، OLE به یک برنامه ویرایش اجازه می دهد تا این “اشیاء” را به یک برنامه ویرایش دیگر صادر کند و سپس آنها را با محتوای اضافی وارد کند.

در این مقاله، ما در مورد قرار دادن یک شی OLE و تنظیم خواص آن در یک سند صحبت خواهیم کرد.

OLE شی را وارد کنید

اگر شیء OLE را می‌خواهید، متد InsertOleObject را فراخوانی کنید و آن را به طور صریح با سایر پارامترها به ProgId ارسال کنید.

مثال کد زیر نشان می دهد که چگونه OLE شی را در یک سند وارد کنید:

تنظیم نام فایل و پسوند هنگام قرار دادن OLE Object

OLE بسته یک روش قدیمی و “غیر مستند” برای ذخیره اشیاء جاسازی شده است اگر یک OLE کنترل کننده ناشناخته باشد.

نسخه های اولیه Windows مانند Windows 3.1، 95 و 98 یک بسته بندی کننده داشتند.برنامه exe که می تواند برای جاسازی هر نوع داده در سند استفاده شود. این برنامه در حال حاضر از Windows حذف شده است، اما Microsoft Word و سایر برنامه ها هنوز از آن برای جاسازی داده ها استفاده می کنند اگر کنترل کننده OLE گم شده یا ناشناخته باشد. کلاس OlePackage به کاربران اجازه می دهد تا به ویژگی های بسته OLE دسترسی داشته باشند.

مثال کد زیر نشان می دهد که چگونه نام فایل، پسوند و نام نمایش را برای بسته OLE تنظیم کنید:

دسترسی به داده های خام شی OLE

کاربران می توانند با استفاده از ویژگی ها و روش های مختلف کلاس OleFormat به داده های شیء OLE دسترسی داشته باشند. به عنوان مثال، امکان دریافت داده های خام شیء OLE یا مسیر و نام یک فایل منبع برای شیء OLE مرتبط وجود دارد.

مثال کد زیر نشان می دهد که چگونه داده های خام شیء OLE را با استفاده از روش GetRawData بدست آوریم:

Ole Object را به عنوان یک نماد وارد کنید

OLE اشیاء را می توان به عنوان تصاویر در اسناد قرار داد.

مثال کد زیر نشان می دهد که چگونه OLE Object را به عنوان یک آیکون وارد کنید. برای این منظور، کلاس DocumentBuilder روش InsertOleObjectAsIcon را نشان می دهد:

مثال کد زیر نشان می دهد که چگونه یک شیء OLE جاسازی شده را به عنوان یک آیکون از یک جریان به سند وارد کنید:

ویدیو آنلاین را وارد کنید

ویدئوی آنلاین را می توان از برگه “Insert” > “Online Video” در سند ورد قرار داد. شما می توانید یک ویدیو آنلاین را در یک سند در مکان فعلی با فراخوانی روش InsertOnlineVideo وارد کنید.

کلاس DocumentBuilder چهار بار اضافی از این روش را معرفی می کند. اولی با محبوب ترین منابع ویدئویی کار می کند و URL ویدیو را به عنوان پارامتر می گیرد. به عنوان مثال، اولین اضافه بار از درج ساده فیلم های آنلاین از YouTube و ویمیو منابع.

مثال کد زیر نشان می دهد که چگونه یک ویدیو آنلاین از Vimeo را در یک سند وارد کنید:

بار دوم با تمام منابع ویدئویی دیگر کار می کند و کد HTML جاسازی شده را به عنوان پارامتر می گیرد. کد HTML برای جاسازی یک ویدیو ممکن است بسته به ارائه دهنده متفاوت باشد، بنابراین برای جزئیات با ارائه دهنده مربوطه تماس بگیرید.

مثال کد زیر نشان می دهد که چگونه یک ویدیو آنلاین را با استفاده از چنین کد HTML در یک سند قرار دهید: