insert_ole_object_as_icon method

insert_ole_object_as_icon(file_name, is_linked, icon_file, icon_caption)

Inserts an embedded or linked OLE object as icon into the document. Allows to specify icon file and caption. Detects OLE object type using file extension.

def insert_ole_object_as_icon(self, file_name: str, is_linked: bool, icon_file: str, icon_caption: str):
    ...

Parameter	Type	Description
file_name	str	Full path to the file.
is_linked	bool	If True then linked OLE object is inserted otherwise embedded OLE object is inserted.
icon_file	str	Full path to the ICO file. If the value is None, Aspose.Words will use a predefined image.
icon_caption	str	Icon caption. If the value is None, Aspose.Words will use the file name.

Returns

Shape node containing Ole object and inserted at the current Builder position.

insert_ole_object_as_icon(file_name, prog_id, is_linked, icon_file, icon_caption)

Inserts an embedded or linked OLE object as icon into the document. Allows to specify icon file and caption. Detects OLE object type using given progID parameter.

def insert_ole_object_as_icon(self, file_name: str, prog_id: str, is_linked: bool, icon_file: str, icon_caption: str):
    ...

Parameter	Type	Description
file_name	str	Full path to the file.
prog_id	str	ProgId of OLE object.
is_linked	bool	If True then linked OLE object is inserted otherwise embedded OLE object is inserted.
icon_file	str	Full path to the ICO file. If the value is None, Aspose.Words will use a predefined image.
icon_caption	str	Icon caption. If the value is None, Aspose.Words will use the file name.

Returns

Shape node containing Ole object and inserted at the current Builder position.

insert_ole_object_as_icon(stream, prog_id, icon_file, icon_caption)

Inserts an embedded OLE object as icon from a stream into the document. Allows to specify icon file and caption. Detects OLE object type using given progID parameter.

def insert_ole_object_as_icon(self, stream: io.BytesIO, prog_id: str, icon_file: str, icon_caption: str):
    ...

Parameter	Type	Description
stream	io.BytesIO	Stream containing application data.
prog_id	str	ProgId of OLE object.
icon_file	str	Full path to the ICO file. If the value is None, Aspose.Words will use a predefined image.
icon_caption	str	Icon caption. If the value is None, Aspose.Words will use the a predefined icon caption.

Returns

Shape node containing Ole object and inserted at the current Builder position.

Examples

Shows how to insert an OLE object into a document.

doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# OLE objects are links to files in our local file system that can be opened by other installed applications.
# Double clicking these shapes will launch the application, and then use it to open the linked object.
# There are three ways of using the InsertOleObject method to insert these shapes and configure their appearance.
# 1 -  Image taken from the local file system:
with system_helper.io.FileStream(IMAGE_DIR + 'Logo.jpg', system_helper.io.FileMode.OPEN) as image_stream:
    # If 'presentation' is omitted and 'asIcon' is set, this overloaded method selects
    # the icon according to the file extension and uses the filename for the icon caption.
    builder.insert_ole_object(file_name=MY_DIR + 'Spreadsheet.xlsx', is_linked=False, as_icon=False, presentation=image_stream)
# If 'presentation' is omitted and 'asIcon' is set, this overloaded method selects
# the icon according to 'progId' and uses the filename for the icon caption.
# 2 -  Icon based on the application that will open the object:
builder.insert_ole_object(file_name=MY_DIR + 'Spreadsheet.xlsx', prog_id='Excel.Sheet', is_linked=False, as_icon=True, presentation=None)
# If 'iconFile' and 'iconCaption' are omitted, this overloaded method selects
# the icon according to 'progId' and uses the predefined icon caption.
# 3 -  Image icon that's 32 x 32 pixels or smaller from the local file system, with a custom caption:
builder.insert_ole_object_as_icon(file_name=MY_DIR + 'Presentation.pptx', is_linked=False, icon_file=IMAGE_DIR + 'Logo icon.ico', icon_caption='Double click to view presentation!')
doc.save(file_name=ARTIFACTS_DIR + 'DocumentBuilder.InsertOleObject.docx')

Shows how to insert an embedded or linked OLE object as icon into the document.

doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# If 'iconFile' and 'iconCaption' are omitted, this overloaded method selects
# the icon according to 'progId' and uses the filename for the icon caption.
builder.insert_ole_object_as_icon(file_name=MY_DIR + 'Presentation.pptx', prog_id='Package', is_linked=False, icon_file=IMAGE_DIR + 'Logo icon.ico', icon_caption='My embedded file')
builder.insert_break(aw.BreakType.LINE_BREAK)
with system_helper.io.FileStream(MY_DIR + 'Presentation.pptx', system_helper.io.FileMode.OPEN) as stream:
    # If 'iconFile' and 'iconCaption' are omitted, this overloaded method selects
    # the icon according to the file extension and uses the filename for the icon caption.
    shape = builder.insert_ole_object_as_icon(stream=stream, prog_id='PowerPoint.Application', icon_file=IMAGE_DIR + 'Logo icon.ico', icon_caption='My embedded file stream')
    set_ole_package = shape.ole_format.ole_package
    set_ole_package.file_name = 'Presentation.pptx'
    set_ole_package.display_name = 'Presentation.pptx'
doc.save(file_name=ARTIFACTS_DIR + 'DocumentBuilder.InsertOleObjectAsIcon.docx')

See Also

• module aspose.words
• class DocumentBuilder