Tablo Biçimlendirme Uygula

Bir tablodaki her öğe farklı bir biçimlendirme ile uygulanabilir. Örneğin tablo biçimlendirme tüm tabloya uygulanacak, satır biçimlendirmesi yalnızca bazı satırlar için, hücre biçimlendirmesi yalnızca bazı hücreler için uygulanacaktır.

Aspose.Words bir tabloya biçimlendirme almak ve uygulamak için zengin bir API sağlar. Biçimlendirme ayarlamak için Table, RowFormat ve CellFormat‘düğümleri kullanabilirsiniz.

Bu makalede farklı tablo düğümlerine biçimlendirme uygulamak ve hangi tablo biçimlendirme ayarlarını Aspose.Words destekler nasıl bu konuda konuşacağız.

Farklı Düğümlerde Biçimlendirme Uygula

Bu bölümde çeşitli tablo düğümleri için biçimlendirme uygulamayı inceleyeceğiz.

Masa Düzeyi Biçimlendirme

Bir tabloya biçimlendirme uygulamak için karşılık gelen Table düğümünde bulunan özellikleri Table, PreferredWidth ve TableCollection sınıflarını kullanarak kullanabilirsiniz.

Tablo özelliklerinin uygulanabilmesi için tablonun en az bir satırı olmalı dikkat edin. Bu şu anlama gelir ki bir tablo oluştururken DocumentBuilder ile, bu biçimlendirme ilk çağrı InsertCell yapıldıktan sonra veya ilk satır tabloya eklendikten sonra veya düğümler doğrudan DOM’ye eklendikten sonra yapılmalıdır.

Aşağıdaki resimler, Table biçimlendirme özelliklerinin Microsoft Word ‘da bir temsilini ve bunların karşılık gelen özellikleri Aspose.Words ‘de gösterir.

Aşağıdaki kod örneği bir tabloya uygulama kenarlığı nasıl uygulanacağını göstermektedir:

Aşağıdaki kod örneği, tüm kenarları etkinleştirilmiş (ızgara) bir tablo oluşturmayı gösterir:

Satır Düzey Biçimlendirme

Sıra düzeyinde** biçimlendirme Row, RowFormat, ve RowCollection sınıflarıyla kontrol edilebilir.

Not edin ki, bir Row yalnızca bir Table‘in alt düğümü olabilir. Aynı zamanda, en az bir tane Cell Row‘da olmalı ki ona biçimlendirme uygulanabilsin.

Aşağıdaki resimler Row biçimlendirme özelliklerinin temsilini Microsoft Word’da ve bunların karşılık gelen özellikleri Aspose.Words’da göstermektedir.

Aşağıdaki kod örneği tablo satırı biçimlendirme değiştirme nasıl gösterir:

Hücre Düzey Biçimlendirme

Hücre düzeyinde biçimlendirme Cell, CellFormat ve CellCollection sınıfları tarafından kontrol edilir.

Not edin bir Cell yalnızca bir Row‘in alt düğümü olabilir. Aynı zamanda bir tane Paragraph en az bir tane olmalı Cell böylece biçimlendirme ona uygulanabilir.

Paragraph‘a ek olarak, bir Table de bir Cell‘ye yerleştirebilirsiniz.

Aşağıdaki resimler, Cell biçimlendirme özellikleri ile ilgili bir temsil ve bunların karşılık gelen özellikleri Aspose.Words ve Microsoft Word gösteriyor.

Aşağıdaki kod örneğinde bir tablo hücresinin biçimlendirmesi nasıl değiştirilir, gösterilmektedir:

Aşağıdaki kod örneğinde, hücrenin içeriğinin sol/üst/sağ/altı kenarına eklenecek boşluk miktarını (noktalar cinsinden) nasıl ayarlayacağınız gösterilmiştir:

Sütun Yüksekliklerini Belirtme

Sütun yüksekliğini ayarlamanın en basit yolu DocumentBuilder‘u kullanmaktır. Uygun RowFormat özelliklerini kullanarak, tabloya ait varsayılan yükseklik ayarını ya da tablodaki her satır için farklı bir yükseklik uygulayabilirsiniz.

Tablo satırı yüksekliği Aspose.Words tarafından kontrol edilir:

• satır yüksekliği özelliği Height
• verilen satır için yükseklik kuralı özelliği HeightRule

Aynı zamanda her satır için farklı bir yükseklik ayarlanabilir – bu sizi tablolarınızın ayarlarını büyük ölçüde kontrol etmenizi sağlar.

Bir nesnenin yüksekliğini belirtmek için kullanılan kural seçenekleri, HeightRule alanlarıyla birlikte ayarlanabilir.

Aşağıdaki kod örneği, tek bir hücre içeren bir tablo oluşturma ve satır biçimlendirme uygulamasını göstermektedir:

Tablo ve Hücre Genişliklerini Belirtin

Bir belge içinde bir Microsoft Word tablosu, tabloyu ve bireysel hücreleri yeniden boyutlandırmanın birkaç farklı yolunu sağlar. Bu özellikler, tablonun görünüşünü ve davranışını kontrol etmek için büyük ölçüde izin verir, o yüzden Aspose.Words tabloların davranışını destekler, örneğin Microsoft Word’de olduğu gibi.

Bu önemli bir nokta çünkü tablo öğelerinin hem genel tablo genişliği hem de bireysel hücrelerin nasıl hesaplandığı üzerinde etkili olabilecek birkaç farklı özelliği vardır:

• Masadaki tercih edilen genişlik
• Tek tek hücrelerin tercih edilen genişliği
• Masaya otomatik olarak sığdırma izin ver

Bu makale çeşitli tablo genişliği hesaplama özelliklerinin nasıl çalıştığını ve tablo genişliği hesaplamasının tam kontrolünü nasıl elde edileceğini ayrıntılarıyla anlatır. Bunun especially useful to know in such cases where the table layout does not appear as expected.

Çoğu durumda, tercih edilen hücre, tablo genişliğinden daha çok tavsiye edilir. Tercih edilen hücre genişliği, Aspose.Words modeli ile birlikte DOCX formatı spesifikasyonuna daha uygundur.

Hücre genişliği aslında DOCX formatı için bir hesaplanmış değerdir. Gerçek hücre genişliği birçok şeyden bağımlı olabilir. Örneğin, sayfa kenar boşluklarını veya tercih edilen tablo genişliğini değiştirmek gerçek hücre genişliğini etkileyebilir.

Tercih edilen hücre genişliği, dokümanda saklanan bir hücre özelliğidir. Hiçbir şeye bağlı değildir ve hücrenin diğer özelliklerini değiştirdiğinizde değişmez.

Bu makalede açıklanan tüm özellikler ve yöntemler, tabloların nasıl çalıştığını Microsoft Word’e bağlar. Bu nedenle çoğu durumda, programatik olarak tablo oluşturuyorsanız ancak istediğiniz tabloyu oluşturmak zor geliyorsa, ilk önce Microsoft Word içinde görsel olarak oluşturmaya çalışabilir ve ardından basitçe biçimlendirme değerlerini uygulamanıza kopyalayabilirsiniz.

Tercih Edilen Genişlik Kullanımı Nasıl Yapılır?

Bir masanın veya bireysel hücrelerin arzu edilen genişliği tercih edilen genişlik özelliği aracılığıyla tanımlanır ve bir öğenin uyum sağlamaya çalıştığı boyuttur. Böylece tercih edilen genişlik tüm tablo için veya bireysel hücreler için belirtilebilir. Bazı durumlarda bu genişliği tam olarak uydurmak mümkün olmayabilir ama gerçek genişlik çoğu durumda bu değere yakın olacaktır.

Uygun tercih edilen genişlik türü ve değeri PreferredWidth sınıfının yöntemleri kullanılarak ayarlanır":

• Auto alanı belirtmek için otomatik veya “tercih edilen genişlik yok”
• FromPercent yöntemini yüzde genişliği belirtmek için kullanın
• FromPoints yöntemini noktalarda genişliği belirtmek için kullanın

Aşağıdaki resimler, Microsoft Word’deki tercih edilen genişlik ayarı özelliklerinin bir gösterimini ve bunların karşılık gelen özellikleri Aspose.Words ‘da gösterir.

Bu seçeneklerin gerçek bir tabloya nasıl uygulandığına ilişkin bir örnek, aşağıdaki resimde görülebilir.

Bir tabloda tercih edilen genişliği kullanmadan önce, tablo en az bir satır içerdiğinden emin olmalısınız. Bu, böyle bir tablo biçimlendirme bir Microsoft Word belgesi veya bir belge Aspose.Words oluşturulmuş satırlarda depolandığı için.

Tercih Edilen Tablo veya Hücre Genişliğini Belirtin

Aspose.Wordsde tablo ve hücre genişlikleri, Table.PreferredWidth özelliğini ve CellFormat.PreferredWidth özelliğini kullanarak ayarlanır, PreferredWidthType numaralandırmasında seçenekler mevcuttur:

• Auto, tercih edilen genişlik ayarlanmamış eşdeğer olarak
• Percent öğeyi pencere veya kapsayıcı boyutuna göre boşluğa yerleştirir ve kullanılabilir genişlik değiştiğinde değeri yeniden hesaplar
• Points, belirtilen noktada bir öğeye karşılık gelir

Varsayılan olarak bir tablo sayfanın mevcut alanının %100’üne yerleştirilebilir. Bu durumda, bu demek oluyor ki tablo sol ve sağ sayfa kenar boşlukları arasında kalan alanı almaya çalışacak.

Table.PreferredWidth özelliğini kullanmak onun tercih edilen genişliğini kapsayıcıya göre ayarlayacaktır: sayfa, metin sütunu veya dış tablo hücresi eğer iç içe geçmiş bir tablo ise.

Aşağıdaki kod örneği, tabloyu sayfa genişliğinin %50’sine otomatik olarak uyum sağlaması için nasıl ayarlanacağını göstermektedir:

Bir hücrede verilen CellFormat.PreferredWidth özelliğini kullanmak, tercih edilen genişliğini ayarlayacaktır.

Aşağıdaki kod örneği farklı tercih edilen genişlik ayarlarını nasıl ayarlayacağınızı göstermektedir:

Tercih Edilen Genişlik Türünü ve Değeri Bul

İstediğiniz tablo veya hücrenin tercih edilen genişlik ayrıntılarını bulmak için Type ve Value özelliklerini kullanabilirsiniz.

Aşağıdaki kod örneği bir tablodaki hücre için tercih edilen genişlik türünü nasıl alacağını göstermektedir:

Nasıl Ayarlayın Autofit

The AllowAutoFit özelliği bir tablodaki hücrelerin seçilen bir kriterle büyümesine ve küçülmesine izin verir. Örneğin, tabloyu sayfanın genişliğine sığacak şekilde kullanmak için Pencereye Otomatik Uyarlama seçeneğini ve içeriğine göre büyüyüp küçülebilecek şekilde her hücrenin izin vermek için İçeriği Otogörmeye Uyarlama seçeneğini kullanabilirsiniz.

Ayrıca, AllowAutoFit özelliği bir hücre genişliğinin tercih edildiği ile birlikte otomatik olarak içeriği sığdıracak bir hücrenin biçimlendirilmesinde kullanılabilir, ancak ayrıca ilk genişliği vardır. Gerekirse hücre genişliği sonra bu genişlikten büyüyebilir.

Varsayılan olarak Aspose.Words, Pencereye Otomatik Uyarlama kullanarak yeni bir tablo ekler. Masa, mevcut sayfa genişliğine göre boyutlandırılacaktır. Bir tabloyu yeniden boyutlandırmak için, AutoFit yöntemini çağırabilirsiniz. Bu yöntem, tabloya uygulanacak otomatik uyum türünü belirtmek için bir AutoFitBehavior numaralandırması kabul eder.

Önemli olan, otomatik uyum yönteminin aslında aynı anda tabloya farklı özellikler uygulayan bir kısayol olduğunu bilmektir. Bu özellikleri, aslında tabloya gözlemlenen davranışı veren özellikler. Bu özellikleri her autofit seçeneği için tartışacağız.

Aşağıdaki kod örneği, içeriğine göre her bir hücrenin küçülmesi veya büyümesi için bir tablo ayarlamayı gösterir:

Biz aşağıdaki tablonun çeşitli otomatik uyum ayarlarını göstermek için kullanılacağını kullanırız.

Pencereden Tabloya Otomatik Uyarlama

Otomatik olarak bir pencereye yerleştirme bir tabloya uygulandığında, aşağıdaki işlemler aslında arka planda gerçekleştirilir:

1. Table.AllowAutoFit özelliği otomatik olarak sütunları mevcut içeriğe uyacak şekilde yeniden boyutlandırmak için %100 değerini kullanan bir Table.PreferredWidth
2. CellFormat.PreferredWidth tüm tablo hücrelerinden kaldırılır
   Bu, Microsoft Word davranışından biraz farklıdır, burada her hücrenin tercih edilen genişliği mevcut boyutlarına ve içeriğine göre uygun değerlere ayarlanır. Aspose.Words tercih edilen genişliği güncellemez, bu yüzden sadece temizlenirler.
3. Sütun genişlikleri, mevcut tablo içeriği için yeniden hesaplanır - sonuç bir tablo işgal eder tüm kullanılabilir genişlik
4. Masa içindeki sütunların genişliği kullanıcı metin düzenlerken otomatik olarak değişir

Aşağıdaki kod örneği, bir tablonun sayfa genişliğine nasıl uyum sağladığını göstermektedir:

Yukarıdaki tabloya bu seçeneklerin nasıl uygulandığını gösteren bir örnek, aşağıdaki resmin altında görülebilir.

İçeriği İçerecek Tabloya Otomatik Uyma

Tablo otomatik olarak uydurulduğunda aşağıdaki adımlar aslında arka planda gerçekleştirilir:

1. The Table.AllowAutoFit özelliği içeriğine göre her bir hücreyi otomatik olarak yeniden boyutlandırmak için etkinleştirilmiştir

2. Tercih edilen tablo genişliği kaldırılır Table.PreferredWidth, her tablo hücresi için CellFormat.PreferredWidth kaldırılır

   Bu otomatik uydurma seçeneğinin tercih edilen genişlikleri hücrelerden kaldırdığını not edin, tıpkı Microsoft Word’te olduğu gibi. Sütun boyutlarını korumak ve içeriğe uyacak şekilde sütunları artırmak veya azaltmak istiyorsanız, Table.AllowAutoFit özelliğini otomatik olarak ayarlamak yerine kendi başına True olarak ayarlamanız gerekir.

3. Sütun genişlikleri, geçerli tablo içeriği için yeniden hesaplanır – sonuç bir tablodur, sütun genişlikleri ve tüm tablo genişliği otomatik olarak içeriğe en iyi şekilde uyacak şekilde yeniden boyutlandırılır kullanıcı metni düzenlerken

Aşağıdaki kod örneğinde bir tabloyu içeriğine nasıl otomatik olarak uydurduğumu gösterir:

Bu seçeneklerin yukarıdaki tabloya nasıl uygulandığının bir örneği, aşağıda resimde görülebilir.

Tablo’da Otomatik Uyarlamayı Kullanmayın ve Sabit Sütun Genişliklerini Kullanın

Bir tablo otomatik uyum yok ve sabit sütun genişlikleri yerine kullanılırsa, aşağıdaki adımlar gerçekleştirilir:

1. Table.AllowAutoFit özelliği devre dışı bırakıldığından nedenle sütunlar içeriğine göre büyümüyor veya küçülmüyor
2. Tam tablo genişliğinin tercih edilen genişlik kaldırıldı Table.PreferredWidth, CellFormat.PreferredWidth tüm tablo hücrelerinden kaldırıldı
3. Sonuç bir tablodur ve satır genişlikleri CellFormat.Width özelliğine göre belirlenir ve kullanıcı metin girdiğinde veya sayfa yeniden boyutlandırıldığında sütunların otomatik olarak yeniden boyutlendirilmediği

Eğer CellFormat.Width için bir genişlik belirtilmezse, varsayılan değerin bir inç (72 noktalar) kullanıldığına dikkat edin.

Aşağıdaki kod örneği belirtilen tablo için otomatik uyum ve sabit genişlik etkinleştirmeyi nasıl devre dışı bırakacağınızı gösterir:

Bu seçeneklerin yukarıdaki tabloya nasıl uygulandığına ilişkin bir örnek, aşağıdaki resimde görülebilir.

Hücre Genişliğinin Hesaplanmasında Öncelik Sırası

Aspose.Words kullanıcıların bir tablonun veya hücrenin genişliğini birden fazla nesne aracılığıyla tanımlamasına izin verir, CellFormat dahil – Width özelliği çoğunlukla önceki sürümlerden miras kalmıştır ancak hücre genişliğini basitleştirmek için hala yararlıdır.

Önemli bir nokta, CellFormat.Width özelliğinin diğer genişlik özelliklerinden hangilerinin zaten tablo içinde bulunduğuna bağlı olarak farklı şekilde çalıştığını bilmektir.

Aspose.Words aşağıdaki sırayı hücre genişliklerini hesaplamak için kullanır:

Sipariş	Mülkiyet	Tanım
1	AllowAutoFit belirlenir	Eğer AutoFit etkinleştirilirse: - tablo, içeriği barındırmak için tercih edilen genişliği aşabilir - genellikle tercih edilen genişlikten daha küçük bir boyuta küçülmez - CellFormat.Width değerindeki herhangi bir değişiklik göz ardı edilir ve hücre içeriğine göre uyum sağlar
2	PreferredWidthType bir değerle, Points ya da Percent	CellFormat.Width yoksayılır
3	PreferredWidthType ile bir değer Auto	Bu değer, CellFormat.Width ‘dan kopyalanır ve hücre’nin tercih edilen genişliği (noktalarda) haline gelir

Genişlik özelliğine yapılan tüm değişiklikler tercih edilen genişlikte güncellenmez ve bunun yerine tercih edilen genişliğe uygulanır.

Sabit tablo düzeni oluştururken hücre genişliğini belirtin. Genişliği olmayan bir hücre, DOC formatında kaydedilemez. DOC dışındaki dosya biçimleri, örneğin DOCX, bir sabit tablo düzeninde genişliği olmayan hücreleri kaydetmeyi ilkelerince sağlar.

Hücreler Arasında Boşluk İçin İzin Ver

Tablo hücreleri arasındaki ekstra boşluğu ayarlayabilir veya alabilirsiniz, tıpkı Microsoft Word’deki ‘Cell spacing’ seçeneğine benzer şekilde. Bunun AllowCellSpacing özelliğini kullanarak yapılabilir.

Bu seçeneklerin bir gerçek tabloya nasıl uygulandığına dair bir örnek, aşağıdaki resimde görülebilir.

Aşağıdaki kod örneği hücreler arasındaki boşluk ayarlamayı nasıl yapacağınızı göstermektedir:

Sınırları ve Gölgelendirmeyi Uygula

Sınırlar ve gölgeleme, tüm tabloya Table.SetBorder, Table.SetBorders ve Table.SetShading kullanılarak uygulanabilir ya da yalnızca belirli hücrelere CellFormat.Borders ve CellFormat.Shading kullanılarak uygulanabilinir. Ayrıca, satır kenarları RowFormat.Borders kullanılarak ayarlanabilir ancak bu şekilde gölgelendirme uygulanamaz.

Aşağıdaki resimler, Microsoft Word’deki kenarlık ve gölge ayarlarını ve bunların karşılık gelen özellikleri Aspose.Words ‘de gösterir.

Aşağıdaki kod örneği farklı kenarlık ve gölgelendirmelerle bir tablo ve hücre nasıl biçimlendirileceğini gösterir: