Model temelli uygulamalarda kılavuzlar ve alt kılavuzlar (İstemci API başvurusu)

Kılavuzlar ve alt kılavuzlar, model temelli uygulamalarda verileri tablo biçiminde sunar. Salt okunur ve düzenlenebilir kılavuzlarla çalışmak için bu makaledeki İstemci API olaylarını ve nesnelerini kullanın. Kılavuzlar formun tamamına yayılabilir veya formdaki öğelerden biri olabilir; ikincisi alt kılavuz olarak adlandırılır.

Kılavuz türleri

Model temelli uygulamalarda iki tür kılavuz vardır:

• Salt okunur kılavuzlar: Verileri tablo biçiminde görüntüler. Salt okunur kılavuzda görüntülenen verileri düzenlemek için kılavuzdaki kaydı seçerek formu açmanız, verileri düzenlemeniz ve sonra kaydetmeniz gerekir.
• Düzenlenebilir kılavuzlar: Verileri tablo biçiminde görüntülemeye ek olarak, web ve mobil istemcilerde, aynı kılavuzdaki verileri gruplandırma, sıralama ve filtreleme özelliği de dahil olmak üzere zengin satır içi düzenleme özellikleri sağlar, böylece kayıt veya görünümler arasında geçiş yapmanız gerekmez. Düzenlenebilir kılavuz özel bir denetimdir ve web istemcisindeki bir formda, panolarda ve mobil istemcilerdeki form kılavuzlarında ana kılavuzda ve alt kılavuzlarda desteklenir. Düzenlenebilir kılavuz denetimi düzenleme özelliği sağlasa da, salt okunur kılavuz meta verilerini ve alan düzeyinde güvenlik ayarlarını dikkate alır.

Kılavuz bağlamını alma

Kılavuz bağlamı, kodunuzu çalıştırmak istediğiniz formdaki kılavuz veya alt kılavuz örneğidir. JavaScript kodunuzu yürütmek için kılavuz bağlamını alma hakkında daha fazla bilgi için bkz. İstemci API'sinin kılavuz bağlamı.

Kılavuz olayları

İsim	Description	Geçerli
Alt Kılavuz OnLoad Olayı	Alt kılavuz her yenilendiğinde gerçekleşir. Bu olay, kullanıcıların sütun başlıklarına tıklayarak alt kılavuzdaki değerleri sıralamasını içerir.	Salt okunur kılavuz
Kılavuz OnChange	Düzenlenebilir kılavuzdaki bir hücrede bir değer değiştirildiğinde ve hücre odağı kaybettiğinde gerçekleşir	Düzenlenebilir ızgara
Kılavuz OnRecordSelect	Düzenlenebilir kılavuzda tek bir satır (kayıt) seçildiğinde gerçekleşir	Düzenlenebilir ızgara
Kılavuz OnSave	Güncelleştirilmiş bilgileri sunucuya göndermeden önce ve aşağıdakilerden herhangi biri gerçekleştiğinde gerçekleşir: Kayıt seçiminde bir değişiklik olduğunda, kullanıcı düzenlenebilir kılavuzun kaydetme düğmesini kullanarak açıkça bir kaydetme işlemini tetikler veya kullanıcı bekleyen değişiklikler varken düzenlenebilir kılavuzdan sıralama, filtreleme, gruplama, sayfalandırma veya gezinti işlemi uygular.	Düzenlenebilir ızgara

Uyarı

Bir tablo veya salt okunur kılavuz için düzenlenebilir kılavuzları etkinleştirmek için kullandığınız model temelli uygulamalar sayfasının Olaylar sekmesini kullanarak OnChange, OnRecordSelect ve OnSave olaylarına kaydolabilirsiniz.

Kılavuz nesneleri

Kılavuzlarla etkileşime geçmek için aşağıdaki nesneleri kullanın. Bu nesneler aşağıdaki diyagramda gösterildiği gibi bir hiyerarşi oluşturur:

İsim	Description	Için kullanılabilir
GridControl	Kılavuz veya alt kılavuz denetimiyle çalışmak için yöntemler sağlar.	Salt okunur ve düzenlenebilir kılavuzlar
Kılavuz	Kılavuzdaki verilerle ilgili bilgilere erişmek için yöntemler sağlar.	Salt okunur ve düzenlenebilir kılavuzlar
GridRow	Kılavuzdaki satırlarla veya seçili satırlarla çalışmak için yöntemler sağlar.	Salt okunur ve düzenlenebilir kılavuzlar
GridRowData	Kılavuzdaki satırlarla veya seçili satırlarla çalışmak için yöntemler sağlar.	Salt okunur ve düzenlenebilir kılavuzlar
GridEntity	Satırlardaki belirli kayıtlarla ilgili verilere erişmek için yöntemler sağlar.	Salt okunur ve düzenlenebilir kılavuzlar
GridAttribute	Düzenlenebilir bir kılavuzun hücresindeki verilere erişmek için yöntemler sağlar.	Düzenlenebilir ızgara
GridCell	Düzenlenebilir kılavuzdaki bir sütuna bağlı bir formdaki denetimle ilgili verilere erişmek için yöntemler sağlar.	Düzenlenebilir ızgara
ViewSelector	Alt kılavuz denetiminin görünüm seçicisi hakkında bilgi almak veya ayarlamak için yöntemler sağlar.	Salt okunur kılavuz

İlgili makaleler

İstemci API kılavuzu bağlamı
Düzenlenebilir kılavuzları kullanma
Model temelli uygulamalar için İstemci API Başvurusu
Model temelli uygulamalar geliştirici kılavuzu