Práce s OLE objekty a online video

OLE (Object Linking and Embedding) je technologie, pomocí které mohou uživatelé pracovat s dokumenty obsahujícími “objekty” vytvořené nebo editované aplikacemi třetích stran. To znamená, že OLE umožňuje editační aplikaci exportovat tyto “objekty” do jiné editační aplikace a pak je importovat s dodatečným obsahem.

V tomto článku budeme hovořit o vložení OLE objektu a nastavení jeho vlastností, stejně jako vložení online videa do dokumentu.

Vložit OLE Předmět

Pokud chcete OLE Objekt, volejte insert_ole_object způsob a předat ProgId explicitně s jinými parametry.

Následující příklad kódu ukazuje, jak vložit OLE Objekt do dokumentu:

Nastavit název a příponu souboru při vkládání OLE objektu

OLE balíček je odkaz a “nedokumentovaný” způsob uložení vložených objektů, pokud je OLE manipulátor neznámý.

Brzy Windows verze jako např. Windows 3.1, 95 a 98 měli Balič. exe aplikace, která by mohla být použita k vložení jakéhokoli typu dat do dokumentu. Tato žádost je nyní vyloučena Windows, ale Microsoft Word a další aplikace je stále používají k vložení dat, pokud OLE manipulátor chybí nebo není znám. • OlePackage třída umožňuje uživatelům přístup k vlastnostem OLE balíčku.

Následující příklad kódu ukazuje, jak nastavit název souboru, příponu a název displeje pro OLE Package:

Získejte přístup k Raw data objektu OLE

Uživatelé mohou přistupovat k OLE objektům pomocí různých vlastností a metod OleFormat třída. Například, je možné získat OLE objekt surových dat nebo cesta a název zdrojového souboru pro propojený OLE objekt.

Následující příklad kódu ukazuje, jak získat OLE Objekt surové údaje pomocí get_raw_data metoda:

Vložit OLE Objekt jako ikona

OLE objekty mohou být také vloženy do dokumentů jako obrázky.

Následující příklad kódu ukazuje, jak vložit OLE Object jako ikonu. Za tímto účelem DocumentBuilder třída odhaluje insert_ole_object_as_icon metoda:

Následující příklad kódu ukazuje, jak vložit vložený OLE objekt jako ikonu z proudu do dokumentu:

Vložit online video

Online video lze vložit do dokumentu Word z záložky “Insert” > “Online Video”. Můžete vložit online video do dokumentu na aktuálním místě voláním insert_online_video metoda.

DocumentBuilder třída zavádí čtyři přetížení této metody. První pracuje s nejpopulárnější video zdroje a bere URL video jako parametr. Například první přetížení podporuje jednoduché vložení online videí z YouTube a Vimeo zdroje.

Následující příklad kódu ukazuje, jak vložit online video z Vimeo do dokumentu:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

# Pass direct url from youtu.be.
url = "https://www.youtube.com/watch?v=t_1LYZ102RA"

width = 360
height = 270

shape = builder.insert_online_video(url, width, height)

doc.save(docs_base.artifacts_dir + "WorkingWithOleObjectsAndActiveX.insert_online_video.docx")

Druhé přetížení pracuje se všemi ostatními video zdroji a bere vložený HTML kód jako parametr. HTML kód pro vložení videa se může lišit v závislosti na poskytovateli, takže kontaktujte příslušného poskytovatele pro podrobnosti.

Následující příklad kódu ukazuje, jak vložit online video do dokumentu pomocí takového HTML kódu:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

# Shape width/height.
width = 360
height = 270

# Poster frame image.
f = open(docs_base.images_dir + "Logo.jpg", "rb")
imageBytes = f.read()
f.close()

# Visible url
vimeoVideoUrl = "https://vimeo.com/52477838"

# Embed Html code.
vimeoEmbedCode = ""

builder.insert_online_video(vimeoVideoUrl, vimeoEmbedCode, imageBytes, width, height)

doc.save(docs_base.artifacts_dir + "WorkingWithOleObjectsAndActiveX.insert_online_video_with_embed_html.docx")