---
title: "کار با OLE اشیاء در C++"
---


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

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

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

اگر شیء OLE را می‌خواهید، متد [InsertOleObject](https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/insertoleobject/) را فراخوانی کنید و آن را به طور صریح با سایر پارامترها به **ProgId** ارسال کنید.

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

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with OleObjects and ActiveX-DocumentBuilderInsertOleObject.h" >}}

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

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

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

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

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with OleObjects and ActiveX-InsertOleObjectwithOlePackage.h" >}}

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

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

مثال کد زیر نشان می دهد که چگونه داده های خام شیء OLE را با استفاده از روش [GetRawData](https://reference.aspose.com/words/cpp/aspose.words.drawing/oleformat/getrawdata/) بدست آوریم:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with OleObjects and ActiveX-GetAccessToOLEObjectRawData.h" >}}

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

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

مثال کد زیر نشان می دهد که چگونه OLE Object را به عنوان یک آیکون وارد کنید. برای این منظور، کلاس [DocumentBuilder](https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/) روش [InsertOleObjectAsIcon](https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/insertoleobjectasicon/) را نشان می دهد:

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with OleObjects and ActiveX-InsertOLEObjectAsIcon.h" >}}

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

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with OleObjects and ActiveX-InsertOLEObjectAsIconUsingStream.h" >}}

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

ویدئوی آنلاین را می توان از برگه *"Insert" > "Online Video"* در سند ورد قرار داد. شما می توانید یک ویدیو آنلاین را در یک سند در مکان فعلی با فراخوانی روش [InsertOnlineVideo](https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/insertonlinevideo/) وارد کنید.

کلاس [DocumentBuilder](https://reference.aspose.com/words/cpp/aspose.words/documentbuilder/) چهار بار اضافی از این روش را معرفی می کند. اولی با محبوب ترین منابع ویدئویی کار می کند و `URL` ویدیو را به عنوان پارامتر می گیرد. به عنوان مثال، اولین اضافه بار از درج ساده فیلم های آنلاین از [YouTube](https://www.youtube.com/) و [ویمیو](https://vimeo.com/) منابع.

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

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with Document-Add content using DocumentBuilder-InsertOnlineVideo.h" >}}

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

{{% alert color="primary" %}}

لطفا توجه داشته باشید که سند به طور خودکار برای MS Word 2013 بهینه سازی خواهد شد تا ویدیو را نشان دهد.

{{% /alert %}}

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

{{< gist "aspose-words-gists" "d55d8631947d283b1f0da99afa06c492" "Examples-DocsExamples-source-Programming with Documents-Working with Document-Add content using DocumentBuilder-InsertOnlineVideoWithEmbedHtml.h" >}}