ShapeCollection.InsertOleObjectAsIcon(DocumentPosition, String, String, Image) Method
In This Article
Inserts an OLE object that contains a link to the specified file. The object is displayed in the document as an icon.
Namespace: DevExpress.XtraRichEdit.API.Native
Assembly: DevExpress.RichEdit.v24.2.Core.dll
NuGet Package: DevExpress.RichEdit.Core
#Declaration
[Browsable(false)]
Shape InsertOleObjectAsIcon(
DocumentPosition pos,
string fileName,
string progId,
Image icon
)
#Parameters
Name | Type | Description |
---|---|---|
pos | Document |
The position of the object’s anchor. |
file |
String | A path to the file associated with the OLE object. |
prog |
String | The file type. You can use constant fields of the Ole |
icon | Image | The icon for the OLE object. |
#Returns
Type | Description |
---|---|
Shape | The OLE object added to the document. |
#Remarks
The following example inserts a linked OLE object as an icon:
Document document = wordProcessor.Document;
// Insert an OLE object. Link it to an Excel worksheet.
// The OLE object is displayed in the document as an icon.
Shape oleObject = document.Shapes.InsertOleObjectAsIcon(document.CreatePosition(1780), @"D:\ExcelWorkbook.xlsx",
OleObjectType.ExcelWorksheet, System.Drawing.Image.FromFile(@"Images\Excel.ico"));
// Specify the object position on the page.
oleObject.RelativeHorizontalPosition = ShapeRelativeHorizontalPosition.Column;
oleObject.RelativeVerticalPosition = ShapeRelativeVerticalPosition.Paragraph;
oleObject.Offset = new PointF(0, 0);
// Specify how text wraps around the object.
oleObject.TextWrapping = TextWrappingType.TopAndBottom;
Open the document in Microsoft® Word® and double-click the icon to open the file associated with the OLE object.
See Also