リンクと参照の操作

リンクと参照の操作

概要

Word のリンクおよび相互参照フィールドコード – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, そしてその他 – はそれぞれ専用の Field サブクラスとして Aspose.Words FOSS for .NET。 これらすべてのクラスは Aspose.Words.Fields 名前空間に他のすべてのフィールドタイプと共に存在します。このページでは、リンク、相互参照、プロンプトされた値、引用に特に関係するものをグループ化し、各クラスが提供する内容を説明します。


Hyperlinks

FieldHyperlink は HYPERLINK フィールドを表します: Address と SubAddress は対象の URL または文書内位置を保持し、ScreenTip はホバー時のツールチップを設定し、OpenInNewWindow と IsImageMap は表示フラグ、Target はブラウザフレームの名前を指定します。簡単なケースでは、DocumentBuilder.InsertHyperlink() は Field オブジェクトを手動で構築せずにハイパーリンクフィールドを直接挿入します。


ブックマークへの相互参照

FieldRef(REF フィールド)、FieldPageRef(PAGEREF)および FieldNoteRef(NOTEREF)は、それぞれ BookmarkName プロパティを介して名前付きブックマークの内容に解決し、InsertHyperlink と InsertRelativePosition が参照をクリック可能にするか、相対位置(「上」/「下」)を報告するかを制御します。FieldRef は段落番号オプション(InsertParagraphNumber、InsertParagraphNumberInFullContext、InsertParagraphNumberInRelativeContext、NumberSeparator)と IncludeNoteOrComment を追加します。FieldStyleRef(STYLEREF)は代わりに、指定された StyleName で書式設定された最も近い段落に解決し、SearchFromBottom によりフィールド位置から遡って検索します。これらのフィールドが対象とするブックマークは DocumentBuilder.StartBookmark() と EndBookmark() で作成され、MoveToBookmark() でナビゲートできます。FieldSet(SET)はブックマークされたテキスト値――BookmarkName と BookmarkText――を定義し、別の場所の REF フィールドがそれを解決できます。


プロンプト値フィールド

FieldAsk (ASK) と FieldFillIn (FILLIN) はフィールドを更新する者から値を要求します: PromptText ユーザーに表示されます、 DefaultResponse フォールバックを提供し、 PromptOnceOnMailMerge メールマージ中の繰り返しプロンプトを制限します。 FieldAsk さらに、その回答を以下に保存します BookmarkName 他のフィールドが参照できるようにします。以下をご覧ください フィールドガイド for IFieldUserPromptRespondent、インタラクティブにプロンプトする代わりに、プログラムでこれらのフィールドに回答を提供するコールバックです。


外部コンテンツとリンクコンテンツ

FieldDde (DDE) と FieldDdeAuto (DDEAUTO) は別アプリケーション内のコンテンツに ProgId、SourceFullName、SourceItem を介してリンクし、InsertAsText、InsertAsHtml、InsertAsPicture、InsertAsRtf、InsertAsUnicode、InsertAsBitmap が挿入される表現を選択し、AutoUpdate / IsLinked が更新動作を制御します。FieldLink (LINK) は OLE リンクに相当し、FormatUpdateType を追加します。FieldImport (IMPORT) と FieldIncludePicture (INCLUDEPICTURE) は SourceFullName と GraphicFilter を通じて外部グラフィックを取り込みます。FieldInclude (INCLUDE) と FieldIncludeText (INCLUDETEXT) は外部文書コンテンツを取り込み、BookmarkName は取り込む範囲を指定し、LockFields は更新を防止します;FieldIncludeText はさらに XML ソースを Encoding、MimeType、NamespaceMappings、XPath、XslTransformation を通じてサポートします。


AutoText と用語集参照

FieldAutoText (AUTOTEXT)、FieldAutoTextList (AUTOTEXTLIST)、および FieldGlossary (GLOSSARY) はすべて、EntryName を介して名前付きビルディングブロックエントリを参照します;FieldAutoTextList はリスト形式の表示のために ListStyle と ScreenTip を追加します。


引用と文献リストのフィールド

FieldCitation (CITATION) と FieldBibliography (BIBLIOGRAPHY) 文書の参考文献データから取得したコンテンツをレンダリングします。 FieldCitation.SourceTag (および代替 AnotherSourceTag) がどのソースを引用しているかを識別し、with Prefix, Suffix, PageNumber, VolumeNumber、そして the Suppress* フラグ (SuppressAuthor, SuppressTitle, SuppressYear) が引用の書式を制御します。 FieldBibliography.SourceTag, FilterLanguageId、そして FormatLanguageId が、レンダリングされた参考文献にどのソースが表示されるか、そしてどの言語で表示されるかを制御します。 Source, Contributor, Person – は以下で取り上げられています 参考文献ガイド.


引用およびシェイプテキストフィールド

FieldQuote (QUOTE) と FieldShape (SHAPE) はどちらもリテラルフィールドテキストを保持する Text プロパティを公開します – FieldQuote はフィールドの位置に直接挿入し、FieldShape は描画シェイプのテキストを保持するフィールドコードに関連付けます。


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

  • シンプルなハイパーリンク挿入には DocumentBuilder.InsertHyperlink() を優先してください。ビルダーショートカットが公開していない ScreenTip や IsImageMap などのプロパティが必要な場合に限り、直接 FieldHyperlink を構築してください。
  • FieldRef、FieldPageRef、FieldNoteRef、および FieldSet はすべて BookmarkName を介して連携します – 参照先ブックマークが存在すること(DocumentBuilder.StartBookmark() / EndBookmark() 経由)を、フィールドが更新される前に確認してください。
  • 設定 FieldOptions.UserPromptRespondent (参照 フィールドガイド) 更新する前に、含むドキュメント FieldAsk or FieldFillIn 無人パイプライン内のフィールド。
  • FieldDde と FieldDdeAuto はレガシーな Windows OLE リンキングメカニズムをモデル化しています – Windows 以外でドキュメントを処理する際は、外部アプリケーションが利用できないため、AutoUpdate と IsLinked を情報提供目的として扱ってください。
  • 引用および参考文献フィールドは、ドキュメントの基礎となる Source レコードが存在する場合にのみ正しく表示されます – 参照 参考文献ガイド それらを構築するために。

一般的な問題

問題原因修正
REF / PAGEREF / NOTEREF フィールドがエラー結果を示しています対象となっている BookmarkName が文書内に存在しませんフィールドを更新する前に、DocumentBuilder.StartBookmark() / EndBookmark() を使用してブックマークを作成してください
ASK / FILLIN フィールドが自動更新をブロックしますIFieldUserPromptRespondent が割り当てられていませんフィールドに FieldOptions.UserPromptRespondent を割り当てるか、DefaultResponse を設定してください
CITATION または BIBLIOGRAPHY フィールドが空になります文書の参考文献データにある Source のいずれとも SourceTag が一致しません一致項目を追加してください Source – 参照 参考文献ガイド
DDE / DDEAUTO / LINK フィールドが更新されませんこれらは現在の環境で利用できない外部 OLE ソースを参照しています元の Windows/OLE コンテキスト外で想定される – 保存された Result を最後に知られている値として扱う

FAQ

FieldRef と FieldStyleRef の違いは何ですか?

FieldRef は名前付きブックマーク(BookmarkName)のコンテンツに解決します;FieldStyleRef は代わりにブックマークに依存せず、指定された StyleName でフォーマットされた最も近い段落に解決します。

手動で Field を作成せずに、シンプルなハイパーリンクを挿入するにはどうすればよいですか?

DocumentBuilder.InsertHyperlink() を呼び出してください。

これらのリンクおよび参照フィールドクラスは、他のフィールドとは別の名前空間にありますか?

いいえ – FieldHyperlink, FieldRef, FieldCitation, このページの残りのクラスは普通です Field サブクラスは Aspose.Words.Fields 名前空間で、同じ名前空間は以下で取り上げられています フィールドガイド.

引用フィールドは文献データモデルとどのように関連していますか?

FieldCitation and FieldBibliography 検索してコンテンツをレンダリングする SourceTag に対して Source 記録は以下で記述されています 参考文献ガイド – フィールドクラスはレンダリングを処理し、そして Source / Contributor クラスは基礎となるデータを保持します。


API Reference の概要

クラス説明
FieldHyperlinkHYPERLINK フィールド; Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / PAGEREF / NOTEREF フィールド; BookmarkNameでコンテンツを解決
FieldStyleRefSTYLEREF フィールド; 指定されたスタイル内の最も近い段落に解決されます
FieldSetSET フィールド; REF が解決するためのブックマークされたテキスト値を定義します
FieldAsk / FieldFillInASK / FILLIN フィールド; 更新時に値の入力を促します
FieldDde / FieldDdeAuto / FieldLinkDDE / DDEAUTO / LINK フィールド; 旧式の OLE リンク外部コンテンツ
FieldImport / FieldIncludePictureIMPORT / INCLUDEPICTURE フィールド; 外部グラフィックコンテンツ
FieldInclude / FieldIncludeTextINCLUDE / INCLUDETEXT フィールド; 外部ドキュメントまたは XML コンテンツ
FieldAutoText / FieldAutoTextList / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY フィールド; 参照ビルディングブロックエントリ
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY フィールド; 書誌情報ソースデータをレンダリング
FieldQuote / FieldShapeQUOTE / SHAPE フィールド; リテラルフィールドテキスト
DocumentBuilder.InsertHyperlink高度なハイパーリンク挿入ショートカット
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark参照対象のブックマーク作成とナビゲーション

参照

 日本語