リンクと参照の操作
概要
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(参照 フィールドガイド) 更新する前に、含むドキュメントFieldAskorFieldFillIn無人パイプライン内のフィールド。 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 の概要
| クラス | 説明 |
|---|---|
FieldHyperlink | HYPERLINK フィールド; Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF フィールド; BookmarkNameでコンテンツを解決 |
FieldStyleRef | STYLEREF フィールド; 指定されたスタイル内の最も近い段落に解決されます |
FieldSet | SET フィールド; REF が解決するためのブックマークされたテキスト値を定義します |
FieldAsk / FieldFillIn | ASK / FILLIN フィールド; 更新時に値の入力を促します |
FieldDde / FieldDdeAuto / FieldLink | DDE / DDEAUTO / LINK フィールド; 旧式の OLE リンク外部コンテンツ |
FieldImport / FieldIncludePicture | IMPORT / INCLUDEPICTURE フィールド; 外部グラフィックコンテンツ |
FieldInclude / FieldIncludeText | INCLUDE / INCLUDETEXT フィールド; 外部ドキュメントまたは XML コンテンツ |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY フィールド; 参照ビルディングブロックエントリ |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY フィールド; 書誌情報ソースデータをレンダリング |
FieldQuote / FieldShape | QUOTE / SHAPE フィールド; リテラルフィールドテキスト |
DocumentBuilder.InsertHyperlink | 高度なハイパーリンク挿入ショートカット |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | 参照対象のブックマーク作成とナビゲーション |