保存オプションの指定

ドキュメントを保存するときに、いくつかの詳細プロパティを設定できます。 Aspose.Words は、保存プロセスをより正確に制御できる SaveOptions クラスを提供します。 SaveOptions オブジェクトを受け入れる save メソッドのオーバーロードがあります。これは、SaveOptions クラスから派生したクラスのオブジェクトである必要があります。各保存形式には、この保存形式の保存オプションを保持する対応するクラスがあります。たとえば、PDF 形式に保存する場合は PdfSaveOptions、画像に保存する場合は ImageSaveOptions があります。この記事では、SaveOptions から派生したいくつかのオプション クラスの操作例を示します。

次のコード例は、ドキュメントを HTML に保存する前に保存オプションを設定する方法を示しています。

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Rendering.docx")
saveOptions = aw.saving.HtmlSaveOptions()
saveOptions.export_roundtrip_information = True
doc.save(docs_base.artifacts_dir + "WorkingWithHtmlSaveOptions.export_roundtrip_information.html", saveOptions)

この記事では、ドキュメントを保存するときに制御できるいくつかのプロパティについて説明します。

パスワードを使用してドキュメントを暗号化する

パスワード プロパティを使用して、暗号化されたドキュメントのパスワードを取得または設定します。選択したドキュメント形式を操作するには、対応するクラスの パスワード プロパティを使用します。

たとえば、ドキュメントを DOC または DOT 形式で保存する場合は、DocSaveOptions クラスの password プロパティを使用します。

次のコード例は、RC4 暗号化方式を使用してドキュメントを暗号化するためのパスワードを設定する方法を示しています。

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.write("Hello world!")
saveOptions = aw.saving.DocSaveOptions()
saveOptions.password = "password"
doc.save(docs_base.artifacts_dir + "WorkingWithDocSaveOptions.encrypt_document_with_password.docx", saveOptions)

ドキュメントを password 形式で保存する場合は、OoxmlSaveOptions クラスの password プロパティを使用します。

次のコード例は、パスワードで暗号化された Docx をロードおよび保存する方法を示しています。

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Document.docx")
saveOptions = aw.saving.OoxmlSaveOptions()
saveOptions.password = "password"
doc.save(docs_base.artifacts_dir + "WorkingWithOoxmlSaveOptions.encrypt_docx_with_password.docx", saveOptions)

すべての形式が暗号化と パスワード プロパティの使用をサポートしているわけではありません。

ドキュメント作成時刻を更新する

Aspose.Words は、created_time プロパティを使用してドキュメントの作成日を UTC で取得または設定する機能を提供します。 update_created_time_property オプションを使用して、保存する前にこの値を更新することもできます。

次のコード例は、ドキュメントの作成時間を更新する方法を示しています。

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Rendering.docx")
saveOptions = aw.saving.PdfSaveOptions()
saveOptions.update_last_printed_property = True
doc.save(docs_base.artifacts_dir + "WorkingWithPdfSaveOptions.update_if_last_printed.pdf", saveOptions)

最後に保存したプロパティを更新する

Aspose.Words は、update_last_saved_time_property プロパティを使用して、last_saved_time プロパティが保存前に更新されるかどうかを決定する値を取得または設定する機能を提供します。

次のコード例は、このプロパティを設定してドキュメントを保存する方法を示しています。

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Document.docx")
saveOptions = aw.saving.OoxmlSaveOptions()
saveOptions.update_last_saved_time_property = True
doc.save(docs_base.artifacts_dir + "WorkingWithOoxmlSaveOptions.update_last_saved_time_property.docx", saveOptions)

白黒画像を 1 ビット/ピクセル形式で保存する

画像保存オプションを制御するには、ImageSaveOptions クラスが使用されます。たとえば、pixel_format プロパティを使用して、生成される画像のピクセル形式を設定できます。 Skiaの作業により、出力画像のピクセル形式が設定値と異なる場合がありますのでご了承ください。

次のコード例は、白黒画像を 1 ピクセルあたり 1 ビットの形式で保存する方法を示しています。

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Rendering.docx")
saveOptions = aw.saving.ImageSaveOptions(aw.SaveFormat.PNG)
saveOptions.page_set = aw.saving.PageSet(1)
saveOptions.image_color_mode = aw.saving.ImageColorMode.BLACK_AND_WHITE
saveOptions.pixel_format = aw.saving.ImagePixelFormat.FORMAT1BPP_INDEXED
doc.save(docs_base.artifacts_dir + "WorkingWithImageSaveOptions.format_1_bpp_indexed.png", saveOptions)