링크 및 참조 작업

링크 및 참조 작업

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은 참조가 클릭 가능한지와 상대 위치(“above” / “below”)를 보고하는지를 제어합니다. 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) 인용하는 출처를 식별하고, Prefix, Suffix, PageNumber, VolumeNumber, 그리고 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를 통해 조정됩니다 – 해당 필드가 업데이트되기 전에 대상 북마크가 (via DocumentBuilder.StartBookmark() / EndBookmark()) 존재하는지 확인하십시오.
• 설정 FieldOptions.UserPromptRespondent (참조 필드 가이드) 포함된 문서를 업데이트하기 전에 FieldAsk or FieldFillIn 자동화된 파이프라인의 필드.
• FieldDde와 FieldDdeAuto은 레거시 Windows OLE 연결 메커니즘을 모델링합니다 – Windows 외부에서 문서를 처리할 때는 AutoUpdate와 IsLinked을 정보용으로만 취급하십시오. 해당 외부 애플리케이션이 존재하지 않기 때문입니다.
• 인용 및 참고문헌 필드는 문서의 기본 Source 레코드가 존재할 때만 올바르게 렌더링됩니다 – 참조 참고문헌 가이드 그것들을 만들기 위해.

일반적인 문제

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 요약

참조

• Aspose.Words for .NET — Enterprise Documentation