문서 설정 작업

문서 설정 작업

문서 설정 작업

콘텐트를 넘어, Word 문서는 애플리케이션 수준 설정을 포함합니다 – 레거시 호환성 스위치, 하이픈 처리 기본 설정, 저장된 메일 병합 구성, 보기 옵션 및 쓰기 방지 상태. Aspose.Words FOSS 용 .NET 이를 통해 노출합니다 Aspose.Words.Settings 네임스페이스와 몇 개의 속성에서 Document. 이 페이지에서는 각 설정 그룹과 그가 제어하는 것과 제어하지 않는 것을 다룹니다.


호환성 옵션

Document.CompatibilityOptions은 CompatibilityOptions 인스턴스로, 수십 개의 불리언 스위치를 보유하고 있어 특정 구버전 워드의 레이아웃 및 간격 동작을 재현합니다 – 예를 들어 GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout, 및 BalanceSingleByteDoubleByteWidth. 문서를 읽는 하위 도구에서 특정 워드 버전의 렌더링 특성을 맞추기 위해 필요한 속성을 직접 설정하십시오.


하이픈 설정

Document.HyphenationOptions은 HyphenationOptions 인스턴스(AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone)이며, 문서에 대한 워드의 하이픈 설정을 저장합니다. 이 속성들은 요청을 왕복(round-trip)합니다; 이 버전에는 페이지 레이아웃 엔진이 포함되어 있지 않기 때문에, Aspose.Words FOSS는 자체적으로 하이픈 구분을 계산하지 않습니다 – 워드는 파일을 열고 페이지 매김할 때 이를 적용합니다.


메일 머지 구성

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 of OdsoFieldMapData: Name, MappedName, Column, Type)와 RecipientDatas(OdsoRecipientDataCollection of OdsoRecipientData: Active, Column, Hash, UniqueTag)가 필드 매핑 및 수신자 목록을 설명합니다.


문서 보기 설정

Document.ViewOptions은(는) Word가 파일을 열 때 표시 방식을 제어하는 ViewOptions 인스턴스로, 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 자체 처리에는 영향을 주지 않습니다.Expected behavior – no fix needed
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가 인터페이스에서 사용할 측정 단위

참조

 한국어