Kenarlıklar ve Gölgelendirme

Kenarlıklar ve Gölgelendirme

Kenarlık ve gölgelendirme biçimlendirmesi Aspose.Words FOSS içinde .NET için iki ilişkili öznitelik sınıfı ile modellenir: Border, tek bir kenarlık çizgisini tanımlar ve Shading, bir arka plan dolgu desenini tanımlar. Paragraflar, tablolar, hücreler ve yazı tipleri her biri kendi biçimlendirme özellikleri aracılığıyla bir BorderCollection (çoklu Border kenarlar) ve tek bir Shading nesnesi sunar.

Tek Tek Kenarlıklarla Çalışma

Bir Border nesnesi bir kenarlık çizgisini temsil eder ve LineStyle ( LineStyle içinden bir enum değeri, örneğin Single, Double, Dot veya Wave), LineWidth, Color, DistanceFromText, Shadow ve tema-bilgili ThemeColor/TintAndShade özelliklerini ortaya çıkarır. ClearFormatting() metodunu bir Border üzerinde çağırarak onu varsayılan (kenarlık yok) durumuna sıfırlayabilirsiniz.

BorderCollection, bir nesnenin kenarları için birden fazla Border nesnesini gruplar. Dört kenar için adlandırılmış özellikleri ortaya çıkar — Left, Right, Top, Bottom — ayrıca iç tablo kenarları için Horizontal ve Vertical. BorderCollection indisleyicisi, bir BorderType enum değeri (Left, Right, Top, Bottom, Horizontal, Vertical, DiagonalDown, DiagonalUp veya None) kullanarak belirli bir kenarı getirir. LineWidth, LineStyle veya Color değerlerini doğrudan koleksiyona ayarlamak, bu değeri içinde bulunduğu tüm kenarlıklara aynı anda uygular; ClearFormatting() koleksiyondaki tüm kenarlıkları birlikte temizler.

Gölgelendirme Uygulama

Shading, bir nesnenin arka plan desenini taşır: BackgroundPatternColor ve ForegroundPatternColor iki desen rengini tanımlar ve Texture (bir TextureIndex enum değeri) deseni seçer — katı dolgular TextureIndex.TextureSolid kullanırken, yüzde ve yönsel desenler (Texture10Percent ile Texture97Pt5Percent, TextureHorizontal, TextureDiagonalCross ve diğerleri) Word’ün gölgelendirme galerisini yeniden üretir. ForegroundPatternThemeColor ve BackgroundPatternThemeColor tema-renk eşdeğerlerini sağlar, ayrıca ForegroundTintAndShade ve BackgroundTintAndShade aracılığıyla renk tonu/karartma ayarı sunar. ClearFormatting(), bir Shading nesnesini dolgu olmamasına sıfırlar.

İpuçları ve En İyi Uygulamalar

• Texture‘ı TextureIndex.TextureSolid olarak ayarlayın ve düz bir arka plan doldurması için BackgroundPatternColor‘yi kullanın — en yaygın gölgelendirme durumu.
• BorderCollection indeksleyicisini (borders[BorderType.Horizontal] / borders[BorderType.Vertical]) kullanarak bir tablonun iç ızgara çizgilerine ulaşın; bu çizgiler adlandırılmış özellikler olarak ortaya çıkarılmamıştır.
• Özellikleri doğrudan bir BorderCollection üzerine ayarlamak (bireysel Left/Right/Top/Bottom Border yerine) tüm kenarlara uniform kenarlık uygulamanın en hızlı yoludur.
• Unutmayın, LineStyle.None görünür çizgiyi kaldırır ancak kenarlığın yapılandırılmış genişliğini veya rengini temizlemez — tam bir sıfırlama için ClearFormatting()‘i kullanın.
• Tablo hücresi ve paragraf kenarlıkları bağımsız BorderCollection örnekleridir; birini ayarlamak diğerini etkilemez.

Yaygın Sorunlar

FAQ

Bir tablo hücresinin dört kenarına da aynı kenarlığı nasıl uygularım?

LineStyle, LineWidth, ve Color‘yi hücrenin BorderCollection üzerine doğrudan ayarlayın, Left, Right, Top ve Bottom‘nin her birine ayrı ayrı ayarlamak yerine — koleksiyon düzeyindeki ayarlayıcılar, içinde bulunduğu her kenarlığa uygulanır.

Border ile Shading arasındaki fark nedir?

Border, bir kenar boyunca çizilen bir çizgiyi (stil, genişlik, renk) tanımlar; Shading, içeriğin arkasındaki bir arka plan dolgu desenini tanımlar. Bunlar bağımsızdır — bir nesne kenarlık olmadan gölgelendirme sahip olabilir veya gölgelendirme olmadan kenarlıklara sahip olabilir.

Bir kenarlığın görsel çizgi desenini kontrol eden enum hangisidir?

LineStyle, Single, Double, Dot, DashSmallGap ve Wave gibi değerlerle.

Bir kenarlığı tamamen kaldırabilir miyim?

Evet — ClearFormatting()‘ı Border veya BorderCollection üzerinde çağırın, ya da LineStyle‘i LineStyle.None olarak ayarlayın.

API Reference Özeti

Ayrıca Bakınız

• Aspose.Words for .NET — Enterprise Documentation