Veri Biçimlendirme
Hücre Verilerini Biçimlendirme Yaklaşımları
Çalışma sayfası hücreleri uygun şekilde biçimlendirildiğinde, hücre içeriğini okuyan kullanıcılar için işlerin daha kolay hale geldiği yaygın bir gerçektir. Hücreleri ve içeriklerini biçimlendirmenin birçok yolu vardır. En basit yol, bir Tasarımcı Elektronik Tablo oluştururken Microsoft Excel’i kullanarak hücreleri biçimlendirmektir. Tasarımcı elektronik tablo oluşturulduktan sonra Aspose.Cells kullanarak bu elektronik tabloyu açabilir ve tüm biçim ayarlarını kaydedebilirsiniz. Hücreleri ve içeriklerini biçimlendirmenin diğer bir yolu ise Aspose.Cells API’sini kullanmaktır. Bu konuda, Aspose.Cells API’nin kullanımıyla hücreleri ve içeriklerini biçimlendirmenin iki yaklaşımını açıklayacağız.
Hücreleri Biçimlendirme
Geliştiriciler, Aspose.Cells’in esnek API’sini kullanarak hücreleri ve içeriklerini biçimlendirebilir. Aspose.Cells, bir Microsoft Excel dosyasını temsil eden Workbook sınıfını sağlar. Workbook sınıfı, bir Excel dosyasındaki her çalışma sayfasına erişim sağlayan WorksheetCollection‘ı içerir. Bir çalışma sayfası, Worksheet sınıfı tarafından temsil edilir. Worksheet sınıfı bir Hücreler koleksiyonu sağlar. Cells koleksiyonundaki her öğe, Cell sınıfının bir nesnesini temsil eder.
Aspose.Cells, Cell sınıfında, bir hücrenin biçimlendirme stili ayarlamak için kullanılan Style özelliğini sağlar. Ayrıca, aynı amaca hizmet eden bir Style sınıfı da sağlar. Hücrelere farklı türde biçimlendirme stilleri uygulayarak arka plan veya ön plan renklerini, kenarlıkları, yazı tiplerini, yatay ve dikey hizalamaları, girinti seviyesini, metin yönünü, döndürme açısını ve çok daha fazlasını ayarlayabilirsiniz.
setStyle Yöntemi Kullanma
Farklı hücrelere farklı biçimlendirme stilleri uygularken, Cell sınıfının setStyle yöntemini kullanmak daha iyidir. Aşağıda, bir hücreye çeşitli biçimlendirme ayarları uygulamak için setStyle yönteminin nasıl kullanılacağını gösteren bir örnek verilmiştir.
Stil Nesnesi Kullanma
Aynı biçimlendirme stiline farklı hücrelere uygularken, Style nesnesini kullanın.
- Workbook sınıfının Styles koleksiyonuna, Workbook sınıfının createStyle metodunu çağırarak Style nesnesi ekleyin.
- Styles koleksiyonundan yeni eklenen Style nesnesine erişin.
- Style nesnesinin istenen özelliklerini ayarlayarak istenen biçimlendirme ayarlarını uygulayın.
- Konfigure edilmiş Style nesnesini istenen hücrenin Style özelliğine atayın.
Bu yaklaşım uygulamalarınızın verimliliğini büyük ölçüde artırabilir ve aynı zamanda bellek tasarrufu sağlayabilir.
Gradyan Dolgu Efektleri Uygulama
Hücreye istenen Gradyan Dolgu Efektlerini uygulamak için, Style nesnesinin setTwoColorGradient metodu uygun şekilde kullanılır.
Kod Örneği
Aşağıdaki çıktı, aşağıdaki kodu çalıştırarak elde edilir.
Gradyan Dolgu Efektlerinin Uygulanması
Hizalama Ayarlarının Yapılandırılması
Hücreleri biçimlendirmek için Microsoft Excel kullanan herkes, Microsoft Excel’deki hizalama ayarlarına aşinadır.
Microsoft Excel’deki Hizalama Ayarları
Yukarıdaki şekilden görebileceğiniz gibi, farklı türde hizalama seçenekleri bulunmaktadır:
- Metin hizalama (yatay & dikey)
- Girinti
- Yönlendirme
- Metin kontrolü
- Metin yönü
Bu tüm hizalama ayarları, Aspose.Cells tarafından tamamen desteklenir ve aşağıda daha detaylı olarak tartışılmaktadır.
Hizalama Ayarlarının Yapılandırılması
Aspose.Cells, bir Excel dosyasını temsil eden Workbook adında bir sınıf sağlar. Workbook sınıfı, Excel dosyasındaki her bir çalışma sayfasına erişime izin veren bir WorksheetCollection’a sahiptir. Bir çalışma sayfası, Worksheet sınıfı tarafından temsil edilir.
Worksheet sınıfı bir Cells koleksiyonu sağlar. Cells koleksiyonundaki her öğe, Cell sınıfının bir nesnesini temsil eder.
Aspose.Cells, Cell sınıfındaki setStyle metodu sağlar. Bu metot, bir hücrenin biçimlendirilmesi için kullanılır. Style sınıfı, yazı tiplerini yapılandırmak için kullanışlı özellikler sağlar.
MetinAlignmentType numaralandırmasını kullanarak herhangi bir metin hizalama türünü seçin. MetinAlignmentType numaralandırmasındaki önceden tanımlanmış metin hizalama tipleri şunlardır:
| Metin Hizalama Türleri | Açıklama |
|---|---|
| Bottom | , alt metin hizalamasını temsil eder |
| Center | , merkez metin hizalamasını temsil eder |
| CenterAcross | , metin hizalamasını çapraz merkezlemeyi temsil eder |
| Distributed | , dağıtılmış metin hizalamasını temsil eder |
| Fill | , doldurma metin hizalamasını temsil eder |
| General | , genel metin hizalamasını temsil eder |
| Justify | , düzgün metin hizalamasını temsil eder |
| Left | , sol metin hizalamasını temsil eder |
| Right | , sağ metin hizalamasını temsil eder |
| Top | , üst metin hizalamasını temsil eder |
|
Style.setJustifyDistributed() yöntemini kullanarak dağıtılmış hizalamayı da uygulayabilirsiniz.
|
Yatay Hizalama
Metni yatay olarak hizalamak için Style nesnesinin setHorizontalAlignment yöntemini kullanın.
Aşağıdaki çıktı, aşağıdaki örnek kodu çalıştırarak elde edilir:
Metni yatay olarak hizalamak
Dikey Hizalama
Metni dikey olarak hizalamak için Style nesnesinin setVerticalAlignment yöntemini kullanın.
Dikey Hizalama merkeze ayarlandığında aşağıdaki çıktı elde edilir.
Metni dikey olarak hizalamak
Girinti
Hücredeki metnin girinti düzeyini ayarlamak için Style nesnesinin setIndentLevel yöntemini kullanabilirsiniz.
Girinti Düzeyi 2 olarak ayarlandığında aşağıdaki çıktı elde edilir.
Girinti düzeyi 2’ye ayarlandı
Yönlendirme
Hücredeki metnin yönlendirmesini (dönüş) Style nesnesinin setRotationAngle yöntemiyle ayarlayın.
Yönlendirme açısı 25’e ayarlandığında aşağıdaki çıktı elde edilir.
Yönlendirme açısı 25’e ayarlandı
Metin Kontrolü
Aşağıdaki bölüm metin kaydırma, sığdırmayı daraltma ve diğer biçimlendirme seçeneklerini ayarlayarak metni nasıl kontrol edeceğinizi tartışmaktadır.
Metni Kaydırma
Bir hücrede metni sarmak, metni okumayı kolaylaştırır: hücrenin yüksekliği, metnin tümünü sığdırmak için ayarlanır, onu kesmez veya bitişik hücrelere taşmaz.
Style nesnesinin setTextWrapped yöntemiyle metni sarmayı açın veya kapatın.
Metni sarma etkinleştirildiğinde aşağıdaki çıktı elde edilir.
Hücre içindeki metin
Sığdırmayı Daraltma
Bir alanı sarmak için bir seçenek, hücre boyutlarına sığdırmak için metin boyutunu küçültmektir. Bunun için Stil nesnesinin IsTextWrapped özelliği true olarak ayarlanır.
Metin hücreye sığdırılmak için aşağıdaki çıktıya ulaşılır.
Hücre sınırları içine sığdırılmış metin
Hücreleri Birleştirme
Microsoft Excel gibi, Aspose.Cells birçok hücreyi bir araya getirerek tek bir hücre oluşturmayı destekler.
İlk satırdaki üç hücrenin birleştirilmesiyle büyük tek bir hücre oluşturulursa aşağıdaki çıktı elde edilir.
Büyük bir hücre oluşturmak için üç hücre birleştirildi
Hücreleri birleştirmek için Cells koleksiyonunun Merge yöntemini kullanın. Birleştirme yöntemi aşağıdaki parametreleri alır:
- İlk satır, birleştirmeye başlamak için ilk satır.
- İlk sütun, birleştirmeye başlamak için ilk sütun.
- Satır sayısı, birleştirilecek satır sayısı.
- Sütun sayısı, birleştirilecek sütun sayısı.
Metin Yönü
Hücrelerde metnin okuma sırasını ayarlamak mümkündür. Okuma sırası, karakterlerin, kelimelerin vb. gösterildiği görsel sıradır. Örneğin, İngilizce soldan sağa bir dil iken Arapça sağdan sola bir dildir.
Okuma sırası Style nesnesinin TextDirection özelliği ile ayarlanır. Aspose.Cells, TextDirectionType numaralandırmasında önceden tanımlanmış metin yönü tiplerini sağlar.
| Metin Yönü Türleri | Açıklama |
|---|---|
| Context | Girilen ilk karakterin diline uygun okuma sırası |
| LeftToRight | Soldan sağa okuma sırası |
| RightToLeft | Sağdan sola okuma sırası |
Metnin okuma sırası sağdan sola olarak ayarlandığında aşağıdaki çıktı elde edilir.
Metin okuma sırası sağdan sola ayarlanıyor
Hücredeki Seçili Karakterleri Biçimlendirme
Yazı Tipi Ayarlarıyla İlgilenme sadece hücreleri nasıl biçimlendireceğini açıklar, ancak yalnızca seçili karakterleri biçimlendirmek istersen ne yapacaksın?
Aspose.Cells bu özelliği destekler. Bu konu bu özelliği nasıl kullanacağınızı açıklar.
Seçili Karakterleri Biçimlendirme
Aspose.Cells, bir Microsoft Excel dosyasını temsil eden Workbook adlı bir sınıf sağlar. Workbook sınıfı, Excel dosyasındaki her çalışma sayfasına erişim sağlayan Worksheets koleksiyonunu içerir. Bir çalışma sayfası Worksheet sınıfı tarafından temsil edilir. Worksheet sınıfı bir Cells koleksiyonu sağlar. Hücreler koleksiyonundaki her bir öğe, Cell sınıfının bir nesnesini temsil eder.
Cell sınıfı, bir hücredeki karakterleri seçmek için aşağıdaki parametreleri alan characters yöntemi sağlar:
- Başlangıç Dizini, seçimin başlayacağı karakterin dizini.
- Karakter Sayısı, seçilecek karakterlerin sayısı.
Çıktı dosyasında, A1 hücresindeki ‘Visit’ kelimesi varsayılan yazı tipi ile biçimlendirilir ancak ‘Aspose!’ kalın ve mavi renklidir.
Seçili karakterleri biçimlendirme
Çalışma Kitabını Etkinleştirme ve Çalışma Sayfasındaki Etkin Bir Hücreyi veya Hücre Aralığını Seçme
Bazen, bir dosyayı Microsoft Excel’de birisi açtığında ilk olarak görünen sayfanın belirli bir çalışma sayfası olmasını isteyebilirsiniz. Ayrıca, belirli bir hücreyi etkinleştirmeniz ve bu hücreye girilmeye başlandığında kaydırma çubuklarının etkin hücreye kaydırılmasını isteyebilirsiniz. Aspose.Cells, yukarıda bahsedilen tüm görevleri yapabilir.
Etkin bir sayfa, bir çalışma kitabı içinde çalıştığınız sayfadır. Etkin sayfanın sekmesindeki adı varsayılan olarak kalındır. Etkin hücre ise seçili olan ve veri girilmeye başlandığında içine veri girilen hücredir. Aynı anda yalnızca bir hücre etkindir. Etkin hücre, diğer hücrelere karşı açıkça görünmesi için kalın bir kenarlıkla çevrilmiştir. Aspose.Cells ayrıca çalışma sayfasındaki bir hücre aralığını seçmenize de olanak tanır.
Bir Sayfayı Etkinleştirme ve Bir Hücreyi Etkin Hale Getirme
Aspose.Cells, bu görevler için belirli bir API sağlar. Örneğin, WorksheetCollection.setActiveSheetIndex yöntemi, etkin bir sayfa ayarlamak için kullanışlıdır. Benzer şekilde, Worksheet.setActiveCell yöntemi bir çalışma sayfasındaki etkin hücreyi ayarlamak ve almak için kullanılır.
Dosya Microsoft Excel’de açıldığında yatay ve dikey kaydırma çubuklarının seçilen veriyi güzel bir görüntü sağlamak için satır ve sütun dizin konumuna kaydırılmasını istiyorsanız, Worksheet.setFirstVisibleRow ve Worksheet.setFirstVisibleColumn özelliklerini kullanın.
Aşağıdaki örnek, bir çalışma sayfasını etkinleştirme ve içindeki bir hücreyi etkin hale getirme şeklini gösterir. Kaydırma çubukları, 2. satırı ve 2. sütunu ilk görünür satır ve sütun olarak kaydırılmıştır.
B2 hücresini etkin hücre olarak ayarlama
Çalışma Sayfasında Bir Hücre Aralığı Seçme
Aspose.Cells, int startRow, int startColumn, int totalRows, int totalColumns, bool removeOthers parametrelerini kullanan Worksheet.selectRange(int startRow, int startColumn, int totalRows, int totalColumns, bool removeOthers) yöntemini sağlar. removeOthers parametresini true olarak kullanarak, çalışma sayfasındaki diğer hücre ya da hücre aralığı seçimleri kaldırılır.
Aşağıdaki örnek, etkin çalışma sayfasında bir hücre aralığı seçme şeklini gösterir.
Satır ve Sütunların Biçimlendirilmesi
Raporun görünümünü sağlamak için elektronik tablo içindeki satır ve sütunları biçimlendirmek, Excel uygulamasının muhtemelen en yaygın kullanılan özelliklerindendir. Aspose.Cells API’leri de veri modeli aracılığıyla bu işlevselliği sunar ve özellikle yazı tipi ve özellikleri, metnin hizalaması, arka plan/önrenkleri, kenarlıkları, sayıların ve tarihsel dizelerin görüntü biçimlendirmesini ele alan Style sınıfını açığa çıkarır. Aspose.Cells API’lerinin sağladığı diğer faydalı bir sınıf ise StyleFlag’dir ve Style nesnesinin tekrar kullanılmasını sağlar.
Bu makalede, satır ve sütunlara biçimlendirme uygulamak için Aspose.Cells for Java API’sını nasıl kullanacağımızı açıklamaya çalışacağız.
Satırları ve Sütunları Biçimlendirme
Aspose.Cells, bir Microsoft Excel dosyasını temsil eden Workbook sınıfını sağlar. Workbook sınıfı, Excel dosyasındaki her çalışma sayfasına erişim sağlayan bir WorksheetCollection içerir. Bir çalışma sayfası, Worksheet sınıfı tarafından temsil edilir. Worksheet sınıfı, Cells koleksiyonunu sağlar. Cells koleksiyonu, Row koleksiyonunu sağlar.
Bir Satırı Biçimlendirme
Row koleksiyonundaki her öğe, bir Satır nesnesini temsil eder. Satır nesnesi, bir satıra biçimlendirme uygulamak için kullanılan applyStyle yöntemini sunar.
Aynı biçimlendirmeyi bir satıra uygulamak için Style objesini kullanın:
- createStyle yöntemini çağırarak Style objesini Workbook sınıfına ekleyin.
- Biçimlendirme ayarlarını uygulamak için Style objesi özelliklerini ayarlayın.
- Yapılandırılmış Style objesini Satır nesnesinin applyStyle yöntemine atayın.
Bir Sütunu Biçimlendirme
Cells koleksiyonu, Columns koleksiyonunu sağlar. Columns koleksiyonundaki her öğe, bir Sütun nesnesini temsil eder. Satır nesnesi gibi, Sütun nesnesi de sütun biçimlendirmesi yapmak için applyStyle yöntemini sunar. Sütun nesnesinin applyStyle yöntemini kullanarak bir sütunu satır biçimleriyle aynı şekilde biçimlendirebilirsiniz.
Satırlar ve Sütunlar için Sayı ve Tarihlerin Görüntü Biçimini Ayarlama
Eğer tam bir satır veya sütunun ekran biçimini sayı ve tarihler için ayarlamanız gerekiyorsa, süreç yukarıda tartışıldığı gibi daha veya daha az aynıdır, ancak metin içeriği için parametreleri ayarlamak yerine, Style.Number veya Style.Custom’ı kullanarak sayılar ve tarihler için biçimlendirme ayarlayacaksınız. Lütfen dikkat edin, Style.Number özelliği tamsayı türündedir ve yerleşik sayı ve tarih biçimlerine işaret ederken, Style.Custom özelliği dize türündedir ve geçerli desenleri kabul eder.