ドキュメント設定の操作

ドキュメント設定の操作

文書設定の操作

コンテンツ以外に、Word 文書はアプリケーションレベルの設定を保持します – レガシー互換性スイッチ、ハイフネーション設定、保存されたメールマージ構成、表示オプション、書き込み保護状態。 Aspose.Words の .NET 用 FOSS これらを通じて公開します Aspose.Words.Settings 名前空間と、いくつかのプロパティ上 Document. このページでは、各設定グループとそれが制御するもの、制御しないものをカバーしています。


互換性オプション

Document.CompatibilityOptions は CompatibilityOptions のインスタンスで、数十のブールスイッチを保持し、特定の旧バージョン Word のレイアウトや間隔の動作を再現します――例えば GrowAutofit、UseWord2010TableStyleRules、UseWord2002TableStyleRules、AdjustLineHeightInTable、AlignTablesRowByRow、NoExtraLineSpacing、SuppressSpacingAtTopOfPage、SpacingInWholePoints、UseFELayout、および BalanceSingleByteDoubleByteWidth です。必要なプロパティを直接設定して、下流ツールが文書を読み取る際に特定の Word バージョンの描画クォークに合わせます。


ハイフネーション設定

Document.HyphenationOptions は HyphenationOptions のインスタンス(AutoHyphenation、ConsecutiveHyphenLimit、HyphenateCaps、HyphenationZone)で、文書の Word ハイフネーション設定を保存します。これらのプロパティはリクエストを往復させます;このエディションにはページレイアウトエンジンが含まれていないため、Aspose.Words FOSS はハイフネーションの改行を自ら計算しません――Word がファイルを開いてページ割り付けを行う際に適用します。


差し込み印刷構成

Document.MailMergeSettings は、MailMergeSettings インスタンスで、文書に記録されたメールマージ設定(MainDocumentType、CheckErrors、Destination、DataSource、DataType、Query、ConnectString、MailSubject、MailAsAttachment、ActiveRecord、および ViewMergedData)と、Clear() と Clone() を格納します。Word の Office Data Source Object メカニズムを介して接続された外部データ ソースについては、MailMergeSettings.Odso が Odso インスタンス(DataSource、DataSourceType、TableName、ColumnDelimiter、FirstRowContainsColumnNames)を公開し、その FieldMapDatas(OdsoFieldMapDataCollection の OdsoFieldMapData: Name、MappedName、Column、Type)と RecipientDatas(OdsoRecipientDataCollection の OdsoRecipientData: Active、Column、Hash、UniqueTag)がフィールドマッピングと受信者リストを記述します。


文書表示設定

Document.ViewOptions は、ViewOptions インスタンスで、Word がファイルを開く際の表示方法(ViewType、ZoomType、ZoomPercent、DisplayBackgroundShape、DoNotDisplayPageBoundaries、および FormsDesign)を制御します。これらのプロパティは、Word の文書表示にのみ影響し、Aspose.Words FOSS 自体の処理には影響を与えません。


書き込み保護

Document.WriteProtection は、WriteProtection インスタンス(IsWriteProtected、ReadOnlyRecommended)で、保護パスワードを設定するための SetPassword() と、候補パスワードを検証するための ValidatePassword() を備えています。


測定単位

MeasurementUnits 列挙体は、Word が文書のインターフェイスで使用すべき測定単位を指定します。


ヒントとベストプラクティス

  • CompatibilityOptions.OptimizeFor(MsWordVersion) はクラスに存在しますが、このビルドでは実装が完了していません — NotImplementedException がスローされます。OptimizeFor に頼って一括でバージョンプロファイルを適用するのではなく、必要な個々の CompatibilityOptions ブールプロパティを直接設定してください。
  • MailMergeSettings and Odso メールマージを保存する configuration 文書に記録されたものです – その構成の読み書きはサポートされていますが、メールマージの実行(ライブデータソースからフィールドを埋め込むこと)はこのオープンソース版には含まれていません。
  • HyphenationOptions と ViewOptions は、Word 自体が適用する表示/UI の設定です — このエディションにはページレイアウトエンジンが含まれていないため、Document.Save() を呼び出してもこれらの設定に基づくテキストの折り返しや表示が変わることは期待しないでください。
  • IsWriteProtected を有効にする前に WriteProtection.SetPassword() を呼び出し、パスワードの生文字列を自分で保存または比較するのではなく、ValidatePassword() を使用して候補パスワードを確認してください。
  • CompatibilityOptions、HyphenationOptions、MailMergeSettings、ViewOptions、WriteProtection はすべて Document から直接取得できます — それらをノードツリーで検索する必要はありません。

一般的な問題

課題原因修正
CompatibilityOptions.OptimizeFor() は NotImplementedException をスローしますこのビルドには実装されていません代わりに個別の CompatibilityOptions ブールプロパティを設定してください
差し込み印刷はデータで文書を埋め込みませんMailMergeSettings はマージ構成のみを保存します;実行はこのエディションに含まれていません保存されたデータソース構成を読み取り、独自のフィールド埋め込みロジックを実行するか、商用版をご利用ください Aspose.Words(.NET 用)
ドキュメントを処理するとき、ViewOptions.ZoomPercent を変更しても目に見える効果はありませんViewOptions は Word の表示にのみ影響し、Aspose.Words FOSS の独自処理には影響しません期待される動作 — 修正は不要です
WriteProtection.ValidatePassword() が予期せず false を返しますSetPassword() が最初に呼び出されていないか、別のパスワードが設定されています検証する前に保護されたパスワードを設定するために SetPassword() を呼び出してください

FAQ

実際のメールマージを実行するために Aspose.Words FOSS を使用できますか?

いいえ。MailMergeSettings と Odso は、ドキュメントに保存されたマージ設定の読み書きを可能にしますが、メールマージ(データソースからフィールドを埋め込むこと)の実行は、このオープンソース版には含まれていません。

CompatibilityOptions.OptimizeFor() は動作しますか?

いいえ――このビルドでは NotImplementedException がスローされます。代わりに、必要な個々の CompatibilityOptions プロパティを直接設定してください。

ドキュメントを編集からパスワードで保護するにはどうすればよいですか?

Document.WriteProtection に対して WriteProtection.SetPassword() を呼び出し、次に IsWriteProtected を設定して保護を有効にします。

HyphenationOptions と ViewOptions は、ドキュメントのレイアウト方式を変更しますか?

いいえ。両方とも、Microsoft Word がファイルを開いて表示する際に適用する保存された設定です。このエディションにはページレイアウトエンジンが含まれていないため、これらの設定は Aspose.Words FOSS がそれらからレイアウトを計算することなく、そのまま通過します。


API Reference の概要

クラス / 列挙型説明
CompatibilityOptionsレガシーな Word バージョンのレイアウト/間隔スイッチ、Document.CompatibilityOptions 経由
Compatibility個別の互換性オプションを命名する列挙体
MsWordVersionCompatibilityOptions.OptimizeFor() が使用する Word バージョンの値
HyphenationOptionsハイフン設定、Document.HyphenationOptions 経由
MailMergeSettings保存されたメール差し込み設定、Document.MailMergeSettings 経由
Odsoメール差し込み用 Office Data Source Object の接続設定
OdsoFieldMapData / OdsoFieldMapDataCollectionODSO データ ソースの列と差し込みフィールドのマッピング
OdsoRecipientData / OdsoRecipientDataCollectionメール差し込みごとの受信者の包含/除外状態
ViewOptionsWord の表示設定(ズーム、書式記号)、Document.ViewOptions 経由
WriteProtection文書の書き込み保護状態、Document.WriteProtection 経由
MeasurementUnitsWord がインターフェイスで使用すべき測定単位

参照

 日本語