Bekerja dengan Objek OLE dan Video Online
OLE (Object Linking and Embedding) adalah teknologi dimana pengguna dapat bekerja dengan dokumen yang berisi “objek” yang dibuat atau diedit oleh aplikasi pihak ketiga. Artinya, OLE mengizinkan aplikasi pengeditan untuk mengekspor “objek” ini ke aplikasi pengeditan lain dan kemudian mengimpornya dengan konten tambahan.
Pada artikel ini, kita akan membahas tentang menyisipkan objek OLE dan mengatur propertinya, serta menyisipkan video online ke dalam dokumen.
Masukkan Objek OLE
Jika Anda menginginkan Objek OLE, panggil metode insert_ole_object dan teruskan ProgId secara eksplisit dengan parameter lainnya.
Contoh kode berikut menunjukkan cara menyisipkan Objek OLE ke dalam dokumen:
Tetapkan Nama File dan Ekstensi saat Memasukkan Objek OLE
Paket OLE adalah cara lama dan “tidak terdokumentasi” untuk menyimpan objek yang disematkan jika penangan OLE tidak diketahui.
Versi Windows awal seperti Windows 3.1, 95, dan 98 memiliki aplikasi Packager.exe yang dapat digunakan untuk menyematkan semua jenis data ke dalam dokumen. Aplikasi ini sekarang dikecualikan dari Windows, namun Microsoft Word dan aplikasi lain masih menggunakannya untuk menyematkan data jika pengendali OLE tidak ada atau tidak diketahui. Kelas OlePackage memungkinkan pengguna untuk mengakses properti Paket OLE.
Contoh kode berikut menunjukkan cara mengatur nama file, ekstensi, dan nama tampilan untuk Paket OLE:
Dapatkan Akses ke Data Mentah Objek OLE
Pengguna dapat mengakses data objek OLE menggunakan berbagai properti dan metode kelas OleFormat. Misalnya, dimungkinkan untuk mendapatkan data mentah objek OLE atau jalur dan nama file sumber untuk objek OLE yang tertaut.
Contoh kode berikut menunjukkan cara mendapatkan data mentah Objek OLE menggunakan metode get_raw_data:
Sisipkan Objek OLE sebagai Ikon
Objek OLE juga dapat disisipkan ke dalam dokumen sebagai gambar.
Contoh kode berikut menunjukkan cara menyisipkan Objek OLE sebagai ikon. Untuk tujuan ini, kelas DocumentBuilder memaparkan metode insert_ole_object_as_icon:
Contoh kode berikut menunjukkan cara menyisipkan objek OLE yang tertanam sebagai ikon dari aliran ke dalam dokumen:
Masukkan Video Daring
Video online dapat disisipkan ke dalam dokumen Word dari tab “Sisipkan” > “Video Online”. Anda dapat memasukkan video online ke dalam dokumen di lokasi saat ini dengan memanggil metode insert_online_video.
Kelas DocumentBuilder memperkenalkan empat kelebihan metode ini. Yang pertama bekerja dengan sumber daya video paling populer dan menggunakan URL video sebagai parameter. Misalnya, kelebihan pertama mendukung penyisipan sederhana video online dari sumber Youtube dan Vimeo.
Contoh kode berikut menunjukkan cara menyisipkan video online dari Vimeo ke dalam dokumen:
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")Kelebihan kedua berfungsi dengan semua sumber daya video lainnya dan menggunakan kode HTML yang disematkan sebagai parameter. Kode HTML untuk menyematkan video mungkin berbeda-beda tergantung penyedianya, jadi hubungi penyedia masing-masing untuk detailnya.
Contoh kode berikut menunjukkan cara memasukkan video online ke dalam dokumen menggunakan kode HTML tersebut:
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")