保存オプションの指定

ドキュメントを保存するときに、いくつかの高度なプロパティを設定できます。 Aspose.Wordsは、保存プロセスのより正確な制御を可能にするSaveOptionsクラスを提供します。 SaveOptionsオブジェクトを受け入れるSaveメソッドのオーバーロードがあります-それはSaveOptionsクラスから派生したクラスのオブジェクトでなければなりません。 たとえば、PDF形式に保存する場合はPdfSaveOptions、Markdown形式に保存する場合はMarkdownSaveOptions、または画像に保存する場合はImageSaveOptionsがあります。PDF形式に保存する場合はMarkdownSaveOptionsImageSaveOptions形式に保存す この記事では、SaveOptionsから派生したいくつかのオプションクラスを使用する例を示します。

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(SpecifySaveOption.class);
String fileName = "TestFile RenderShape.docx";
// Load the document.
Document doc = new Document(dataDir + fileName);
// This is the directory we want the exported images to be saved to.
File imagesDir = new File(dataDir, "Images");
// The folder specified needs to exist and should be empty.
if (imagesDir.exists())
imagesDir.delete();
imagesDir.mkdir();
// Set an option to export form fields as plain text, not as HTML input elements.
HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.HTML);
options.setExportTextInputFormFieldAsText(true);
options.setImagesFolder(imagesDir.getPath());
dataDir = dataDir + Utils.GetOutputFilePath(fileName);
doc.save(dataDir, options);

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

パスワードで文書を暗号化する

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

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

次のコード例は、RC4暗号化メソッドを使用して文書を暗号化するパスワードを設定する方法を示しています:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Document.doc");
DocSaveOptions docSaveOptions = new DocSaveOptions();
docSaveOptions.setPassword("password");
dataDir = dataDir + "Document.Password_out.doc";
doc.save(dataDir, docSaveOptions);

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

次のコード例は、パスワードで暗号化されたOpenDocumentを読み込んで保存する方法を示しています:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "encrypted.odt", new com.aspose.words.LoadOptions("password"));
doc.save(dataDir + "out.odt", new OdtSaveOptions("newpassword"));

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

ドキュメント保存の進行状況通知を表示する

Aspose.Wordsは、ProgressCallbackプロパティを使用して、ドキュメントの保存の進行状況に関する通知を取得する機能を提供します。

に保存するときに利用できるようになりましたDOCX, FlatOpc, DOCM, DOTM, DOTX, HTML, MHTML, EPUB, XamlFlow, XamlFlowPack, またはTXT形式。

文書の作成時間を更新する

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

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// For complete examples and data files, please go to //
// https://github.com/aspose-words/Aspose.Words-for-Java
// Open a document
Document doc = new Document(dataDir + "Rendering.doc");
PdfSaveOptions saveOptions = new PdfSaveOptions();
saveOptions.setUpdateLastPrintedProperty(false);
doc.save(dataDir + "PdfSaveOptions.UpdateIfLastPrinted.pdf", saveOptions);

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

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

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document(dataDir + "Document.doc");
OoxmlSaveOptions ooxmlSaveOptions = new OoxmlSaveOptions();
ooxmlSaveOptions.setUpdateLastSavedTimeProperty(true);
dataDir = dataDir + "UpdateLastSavedTimeProperty_out.docx";
doc.save(dataDir, ooxmlSaveOptions);

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

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

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

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
ImageSaveOptions opt = new ImageSaveOptions(SaveFormat.PNG);
opt.setPageSet(new PageSet(1));
opt.setImageColorMode(ImageColorMode.BLACK_AND_WHITE);
opt.setPixelFormat(ImagePixelFormat.FORMAT_1_BPP_INDEXED);
dataDir = dataDir + "Format1bppIndexed_Out.Png";
doc.save(dataDir, opt);