ドキュメント設定の操作
文書設定の操作
コンテンツ以外に、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ブールプロパティを直接設定してください。MailMergeSettingsandOdsoメールマージを保存する 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 | 個別の互換性オプションを命名する列挙体 |
MsWordVersion | CompatibilityOptions.OptimizeFor() が使用する Word バージョンの値 |
HyphenationOptions | ハイフン設定、Document.HyphenationOptions 経由 |
MailMergeSettings | 保存されたメール差し込み設定、Document.MailMergeSettings 経由 |
Odso | メール差し込み用 Office Data Source Object の接続設定 |
OdsoFieldMapData / OdsoFieldMapDataCollection | ODSO データ ソースの列と差し込みフィールドのマッピング |
OdsoRecipientData / OdsoRecipientDataCollection | メール差し込みごとの受信者の包含/除外状態 |
ViewOptions | Word の表示設定(ズーム、書式記号)、Document.ViewOptions 経由 |
WriteProtection | 文書の書き込み保護状態、Document.WriteProtection 経由 |
MeasurementUnits | Word がインターフェイスで使用すべき測定単位 |