테두리 및 음영

테두리 및 음영

Aspose.Words FOSS for .NET에서 테두리 및 음영 서식은 두 개의 관련 속성 클래스인 Border(단일 테두리 선을 설명)와 Shading(배경 채우기 패턴을 설명)으로 모델링됩니다. 단락, 표, 셀 및 글꼴은 각각 해당 서식 속성을 통해 BorderCollection(다중 Border 면)와 단일 Shading 객체를 노출합니다.

개별 테두리 작업

Border 객체는 하나의 테두리 선을 나타내며 LineStyle(LineStyle의 열거형 값이며, 예를 들어 Single, Double, Dot, Wave 등), LineWidth, Color, DistanceFromText, Shadow, 그리고 테마 인식 ThemeColor/TintAndShade 속성을 노출합니다. Border에 대해 ClearFormatting()을 호출하면 기본값(테두리 없음) 상태로 재설정됩니다.

BorderCollection은(는) 객체의 면을 위한 여러 Border 객체를 그룹화합니다. 네 개의 가장자리에 대한 명명된 속성 — Left, Right, Top, Bottom — 외에도 내부 표 테두리를 위한 Horizontal 및 Vertical을 노출합니다. BorderCollection 인덱서는 BorderType 열거형 값(Left, Right, Top, Bottom, Horizontal, Vertical, DiagonalDown, DiagonalUp, None)을 키로 사용하여 특정 면을 검색합니다. 컬렉션에 LineWidth, LineStyle, 또는 Color을 직접 설정하면 포함된 모든 테두리에 해당 값이 한 번에 적용됩니다; ClearFormatting()는 컬렉션의 모든 테두리를 동시에 삭제합니다.

음영 적용

Shading은(는) 객체의 배경 패턴을 담고 있습니다: BackgroundPatternColor와 ForegroundPatternColor가 두 개의 패턴 색상을 정의하고, Texture( TextureIndex 열거형 값)으로 패턴을 선택합니다 — 단색 채우기는 TextureIndex.TextureSolid를 사용하고, 백분율 및 방향성 패턴(Texture10Percent부터 Texture97Pt5Percent, TextureHorizontal, TextureDiagonalCross 등)은 Word의 음영 갤러리를 재현합니다. ForegroundPatternThemeColor과 BackgroundPatternThemeColor은 테마 색상에 해당하는 값을 제공하며, ForegroundTintAndShade와 BackgroundTintAndShade을 통한 색조/그라데이션 조정도 가능합니다. ClearFormatting()는 Shading 객체를 채우기 없음 상태로 재설정합니다.

팁 및 모범 사례

• Texture를 TextureIndex.TextureSolid으로 설정하고 BackgroundPatternColor를 사용하여 단색 배경 채우기를 적용하십시오 — 가장 일반적인 음영 사례입니다.
• BorderCollection 인덱서(borders[BorderType.Horizontal] / borders[BorderType.Vertical])를 사용하여 테이블의 내부 그리드 라인에 접근하십시오. 이는 명명된 속성으로 노출되지 않습니다.
• BorderCollection에 직접 속성을 설정하는 것이(개별 Left/Right/Top/Bottom Border에 설정하는 것보다) 모든 면에 균일한 테두리를 적용하는 가장 빠른 방법입니다.
• LineStyle.None는 테두리의 설정된 너비나 색상을 삭제하지 않고 보이는 선만 제거한다는 점을 기억하십시오 — 전체 초기화를 위해서는 ClearFormatting()을 사용하십시오.
• 표 셀과 단락 테두리는 독립적인 BorderCollection 인스턴스이며, 하나를 설정해도 다른 쪽에 영향을 주지 않습니다.

일반적인 문제

FAQ

표 셀의 네 면 모두에 동일한 테두리를 적용하려면 어떻게 해야 하나요?

셀의 BorderCollection에 LineStyle, LineWidth, Color를 직접 설정하고 Left, Right, Top, Bottom 각각에 따로 설정하지 마세요 — 컬렉션 수준 설정자는 포함된 모든 테두리에 적용됩니다.

Border와 Shading의 차이점은 무엇인가요?

Border은(는) 가장자리를 따라 그려지는 선(스타일, 너비, 색상)을 나타냅니다; Shading은(는) 내용 뒤의 배경 채우기 패턴을 나타냅니다. 이들은 독립적입니다 — 객체는 테두리 없이 음영을 가질 수 있고, 테두리만 가질 수도 있습니다.

테두리의 시각적 선 패턴을 제어하는 enum은 무엇인가요?

LineStyle, 여기에는 Single, Double, Dot, DashSmallGap, Wave와 같은 값이 포함됩니다.

테두리를 완전히 제거할 수 있나요?

예 — Border 또는 BorderCollection에 ClearFormatting()을 호출하거나, LineStyle을 LineStyle.None로 설정하십시오.

API Reference 요약

참조

• Aspose.Words for .NET — Enterprise Documentation