کار با اشیاء Ole
OLE مخفف “پیوند و جاسازی شی” است. این فناوری است که کاربران می توانند با اسناد حاوی “اشیاء” ایجاد شده یا ویرایش شده توسط برنامه های شخص ثالث کار کنند. یعنی، OLE به یک برنامه اجازه می دهد تا این “اشیاء” را برای ویرایش به یک برنامه دیگر صادر کند، و سپس آنها را با برخی از محتوای اضافی وارد کند.
در این مقاله، ما در مورد قرار دادن یک شی OLE و تنظیم خواص آن در یک سند صحبت خواهیم کرد.
Ole شی را وارد کنید
اگر شیء OLE را می‌خواهید، متد InsertOleObject را فراخوانی کنید و آن را به طور صریح با سایر پارامترها به ProgId ارسال کنید.
مثال کد زیر نشان می دهد که چگونه OLE شی را در یک سند وارد کنید:
تنظیم نام فایل و پسوند هنگام قرار دادن OLE Object
OLE بسته یک روش قدیمی و “غیر مستند” برای ذخیره اشیاء جاسازی شده است اگر یک OLE کنترل کننده ناشناخته باشد.
نسخه های اولیه Windows مانند Windows 3.1، 95 و 98 دارای برنامه Packager.exe بودند که می توانستند برای جاسازی هر نوع داده در سند استفاده شوند. این برنامه در حال حاضر از Windows حذف شده است، اما Microsoft Word و سایر برنامه ها هنوز از آن برای جاسازی داده ها استفاده می کنند اگر کنترل کننده OLE گم شده یا ناشناخته باشد. کلاس OlePackage به کاربران اجازه می دهد تا به ویژگی های OLE Package دسترسی داشته باشند.
مثال کد زیر نشان می دهد که چگونه نام فایل، پسوند و نام نمایش را برای OLE Packageتنظیم کنید:
دسترسی به داده های خام شی OLE
کاربران می توانند با استفاده از ویژگی ها و روش های مختلف کلاس OleFormat به داده های شیء OLE دسترسی داشته باشند. به عنوان مثال، امکان دریافت داده های خام شیء OLE یا مسیر و نام یک فایل منبع برای شیء OLE مرتبط وجود دارد.
مثال کد زیر نشان می دهد که چگونه داده های خام شیء OLE را با استفاده از روش GetRawData بدست آوریم:
OLE شی را به عنوان یک آیکون وارد کنید
OLE اشیاء را می توان به عنوان تصاویر در اسناد قرار داد.
مثال کد زیر نشان می دهد که چگونه OLE Object را به عنوان یک آیکون وارد کنید. برای این منظور، کلاس DocumentBuilder روش InsertOleObjectAsIcon را نشان می دهد.
مثال کد زیر نشان می دهد که چگونه یک شیء OLE جاسازی شده را به عنوان یک آیکون از یک جریان به سند وارد کنید:
ویدیو آنلاین را وارد کنید
ویدئوی آنلاین را می توان از برگه “Insert” > “Online Video” در سند ورد قرار داد. شما می توانید یک ویدیو آنلاین را در یک سند در مکان فعلی با فراخوانی روش InsertOnlineVideo وارد کنید:
کلاس DocumentBuilder چهار بار اضافی از این روش را معرفی می کند. اولی با محبوب ترین منابع ویدئویی کار می کند و URL ویدئو را به عنوان پارامتر می گیرد. به عنوان مثال، اولین اضافه بار از درج ساده فیلم های آنلاین از YouTube و ویمیو منابع.
مثال کد زیر نشان می دهد که چگونه یک ویدیو آنلاین از Vimeo را در یک سند وارد کنید:
بار دوم با تمام منابع ویدئویی دیگر کار می کند و کد HTML جاسازی شده را به عنوان پارامتر می گیرد. کد HTML برای جاسازی یک ویدیو ممکن است بسته به ارائه دهنده متفاوت باشد، بنابراین برای جزئیات با ارائه دهنده مربوطه تماس بگیرید.
مثال کد زیر نشان می دهد که چگونه یک ویدیو آنلاین را با استفاده از چنین کد HTML در یک سند قرار دهید: