Cells GridWeb'le çalışma
Çalışma Sayfasından Cells’e erişim
Bu konu, GridWeb’in en temel özelliğine bakarak hücreleri ele almaktadır: hücrelere erişim.
Her çalışma sayfası, GridCell nesnelerinin bir koleksiyonu olan bir GridCells nesnesi içerir. GridCell nesnesi Aspose.Cells.GridWeb’deki bir hücreyi temsil eder. GridWeb’i kullanarak herhangi bir hücreye erişmek mümkündür. Tercih edilen iki yöntem vardır:
Aşağıda her bir yaklaşım tartışılmaktadır.
Cell Adını Kullanma
Tüm hücrelerin benzersiz bir adı vardır. Örneğin A1, A2, B1, B2 vb. Aspose.Cells.GridWeb, geliştiricilerin hücre adını kullanarak istenilen herhangi bir hücreye erişmesine olanak tanır. Hücre adını (dizin olarak) GridWorksheet’in GridCells koleksiyonuna aktarmanız yeterlidir.
Satır ve Sütun İndekslerini Kullanma
Bir hücre aynı zamanda satır ve sütun indeksleri açısından konumuna göre de tanınabilir. Bir hücrenin satır ve sütun indekslerini GridWorksheet’in GridCells koleksiyonuna aktarmanız yeterlidir. Bu yaklaşım yukarıdaki yaklaşımdan daha hızlıdır.
Cell Değerine Erişme ve Değiştirme
Çalışma Sayfasından Cells’e erişim hücrelere erişmeyi tartıştı. Bu konu, GridWeb API kullanılarak hücre değerlerine nasıl erişileceğini ve değiştirileceğini gösterecek şekilde bu tartışmayı genişletmektedir.
Cell’in Değerine Erişme ve Değiştirme
Dize Değerleri
Bir hücrenin değerine erişmeden ve onu değiştirmeden önce hücrelere nasıl erişeceğinizi bilmeniz gerekir. Hücrelere erişmeye yönelik farklı yaklaşımlar hakkında ayrıntılar için bkz.Çalışma Sayfasından Cells’e erişim.
Her hücrenin getStringValue() adında bir özelliği vardır. Bir hücreye erişildiğinde geliştiriciler, hücrenin dize değerine erişmek için getStringValue() yöntemine erişebilir.
Her Türlü Değer
Aspose.Cells.GridWeb ayrıca her hücre için putValue adında özel bir yöntem sağlar. Bu yöntemle bir hücreye herhangi bir türde değer (Boolean, int, double, DateTime ve string) eklemek veya değiştirmek mümkündür.
Ayrıca putValue yönteminin, dize biçimindeki her türlü değeri alıp otomatik olarak uygun bir veri türüne dönüştürebilen aşırı yüklenmiş bir sürümü de vardır. Bunu gerçekleştirmek için, aşağıdaki örnekte gösterildiği gibi Boolean değerini true putValue yönteminin başka bir parametresine iletin.
Cells’e Formül Ekleme
Aspose.Cells.GridWeb’in sunduğu en değerli özellik formül veya fonksiyon desteğidir. Aspose.Cells.GridWeb’in çalışma sayfalarındaki formülleri hesaplayan kendi Formül Motoru vardır. Aspose.Cells.GridWeb hem yerleşik hem de kullanıcı tanımlı işlevleri veya formülleri destekler. Bu konu, Aspose.Cells.GridWeb API’i kullanarak hücrelere formül eklemeyi ayrıntılı olarak açıklamaktadır.
Formül Nasıl Eklenir ve Hesaplanır?
Hücrenin Formül özelliğini kullanarak hücrelere formül eklemek, formüllere erişmek ve bunları değiştirmek mümkündür. Aspose.Cells.GridWeb, basitten karmaşığa kadar kullanıcı tanımlı formülleri destekler. Ancak çok sayıda yerleşik işlev veya formül (Microsoft Excel’e benzer) Aspose.Cells.GridWeb ile birlikte sağlanır. Yerleşik işlevlerin tam listesini görmek için lütfen buna bakındesteklenen işlevlerin listesi.
Formül söz dizimi Microsoft Excel söz dizimi ile uyumlu olmalıdır. Örneğin, tüm formüller eşittir işaretiyle (=) başlamalıdır.
Bir formülü programlı olarak eklemek için, Aspose.Cells.GridWeb, = işaretini kullanmasanız bile, ancak GUI’de çalışan son kullanıcıların bunu kullanması gerekiyorsa, onu bir formül olarak tanıyacaktır.
Formül B3 hücresine eklendi ancak GridWeb tarafından hesaplanmadı
Yukarıdaki ekran görüntüsünde B3’e bir formülün eklendiğini ancak henüz hesaplanmadığını görebilirsiniz. Tüm formülleri hesaplamak için, aşağıda gösterildiği gibi çalışma sayfalarına formülleri ekledikten sonra GridWeb denetiminin GridWorksheetCollection ‘ın hesaplamaFormula yöntemini çağırın.
Kullanıcılar ayrıca Gönder*‘i tıklayarak formülleri hesaplayabilirler.
GridWeb’in Gönder düğmesine tıklamak
ÖNEMLİ: Bir kullanıcı Kaydet’i tıklarsa veyaGeri alma düğmeler veya sayfa sekmeleri, tüm formüller GridWeb tarafından otomatik olarak hesaplanır.
Hesaplamadan sonra formül sonucu
Diğer Çalışma Sayfalarından Cells’e Referans Verme
Aspose.Cells.GridWeb’i kullanarak, farklı çalışma sayfalarında saklanan değerleri formüllerinde referans alarak karmaşık formüller oluşturmak mümkündür.
Farklı bir çalışma sayfasındaki bir hücre değerine başvuruda bulunmanın sözdizimi şöyledir: SayfaAdı!HücreAdı.
GridWeb’in GridCell’inde Veri Doğrulaması Oluşturma
Aspose.Cells.GridWeb eklemenizi sağlarVeri doğrulama GridWorksheet.getValidations().add() yöntemini kullanarak. Bu yöntemi kullanarak şunları belirtmeniz gerekir:Cell Aralık. Ancak tek bir GridCell’de Veri Doğrulaması oluşturmak istiyorsanız bunu doğrudan GridCell.createValidation() yöntemini kullanarak yapabilirsiniz. Benzer şekilde Veri Doğrulamayı da kaldırabilirsiniz GridCell.removeValidation() yöntemini kullanarak bir GridCell’den.
Aşağıdaki örnek kod bir oluştururVeri doğrulama B3 hücresinde. 20 ile 40 arasında olmayan bir değer girerseniz B3 hücresi görünecektir.Doğrulama Hatası şeklindekırmızı bu ekran görüntüsünde gösterildiği gibi.
Özel Komut Düğmeleri Oluşturma
Aspose.Cells.GridWeb, Gönder, Kaydet ve Geri Al gibi özel düğmeler içerir. Tüm bu düğmeler Aspose.Cells.GridWeb için belirli görevleri yerine getirir. Özel görevleri gerçekleştiren özel düğmeler eklemek de mümkündür. Bu konu, bu özelliğin nasıl kullanılacağını açıklamaktadır.
Aşağıdaki örnek kod, özel bir komut düğmesinin nasıl oluşturulacağını ve tıklama olayının nasıl işleneceğini açıklamaktadır. Özel komut düğmeniz için herhangi bir simgeyi kullanabilirsiniz. Gösterim amacıyla bu resim simgesini kullandık.
Aşağıdaki ekran görüntüsünde görebileceğiniz gibi, kullanıcı özel komut düğmesini tıkladığında A1 hücresine şunu söyleyen bir metin ekler:“Özel Komut Düğmem Tıklandı."
Özel Komut Düğmesinin Olay İşleme
Aşağıdaki örnek kod, özel komut düğmesinin olay işlemesinin nasıl gerçekleştirileceğini açıklamaktadır.
GridWeb için hücreleri biçimlendirme
Olası Kullanım Senaryoları
GridWeb artık kullanıcıların hücre verilerini %3 gibi yüzde biçiminde girmelerini destekliyor ve hücredeki veriler otomatik olarak %3,00 olarak biçimlendirilecek. Ancak, hücre stilini GridTableItemStyle.NumberType a 9 veya 10 olan Yüzde Biçimi’ne ayarlamanız gerekecektir. 9 sayısı %3’ü %3 olarak biçimlendirecek, ancak 10 sayısı %3’ü %3,00 olarak biçimlendirecektir.
GridWeb Çalışma Sayfasının Cell Verilerini Yüzde Formatında Girin
Aşağıdaki örnek kod, A1 GridTableItemStyle.NumberType hücresini 10 olarak ayarlar, dolayısıyla giriş verileri %3, ekran görüntüsünde gösterildiği gibi otomatik olarak %3,00 olarak biçimlendirilir.