EditForm, NewForm, SubmitForm, ResetForm ve ViewForm işlevleri

Şunlar için geçerlidir: Tuval uygulamaları

Edit form denetiminde bir öğeyi görüntüleyin, düzenleyin veya öğe oluşturun, içerikleri kaydedin ve denetimleri sıfırlayın.

Genel bakış

Bu işlevler, Edit form denetiminin durumunu değiştirir. Form denetimi bu modlardan birinde olabilir:

Açıklama

Bu işlevler genellikle Button veya Image denetimlerinin OnSelect formülünden çağrılır. Böylece kullanıcı, düzenlemeleri kaydedebilir ve iptal edebilir veya kayıt oluşturabilir. Eksiksiz bir çözüm elde etmek için bu denetimleri ve işlevleri birlikte kullanabilirsiniz.

Bu işlevler değer döndürmez.

Bu işlevleri yalnızca davranış formüllerinde kullanabilirsiniz.

SubmitForm

Form denetimindeki herhangi bir değişikliği veri kaynağına kaydetmek için Button denetiminin OnSelect özelliğinde SubmitForm işlevini kullanın.

Değişiklikler gönderilmeden önce bu işlev, gerekli olarak işaretlenmiş veya değerinde bir ya da daha fazla kısıtlama olan alanlarda doğrulama sorunu olup olmadığını denetler. Bu davranış, Validate işlevinin davranışı ile eşleşir.

Ayrıca SubmitForm, Form denetiminin Valid özelliğini de denetler. Bu, Form denetiminin içerdiği Card denetimlerinin tüm Valid özelliklerinin toplamına işaret eder. Bir sorun oluşursa veriler gönderilmez ve Form denetiminin Error ve ErrorKind özellikleri uygun şekilde ayarlanır.

Doğrulama başarılı olursa SubmitForm, değişikliği veri kaynağına gönderir.

• İşlem başarılı olursa Form denetiminin OnSuccess davranışı çalıştırılır ve Error ile ErrorKind özellikleri temizlenir. Form, FormMode.New modundaysa FormMode.Edit moduna döndürülür.
• İşlem başarısız olursa Form denetiminin OnFailure davranışı çalıştırılır ve Error ile ErrorKind özellikleri uygun şekilde ayarlanır. Formun modu değiştirilmez.

EditForm

EditForm işlevi, Form denetiminin modunu FormMode.Edit olarak değiştirir. Bu modda, Form denetiminin Item özelliğinin içerikleri, formun doldurulması için kullanılır. Form bu moddayken SubmitForm işlevi çalıştırılırsa kayıt oluşturulmaz, değiştirilir. FormMode.Edit, Form denetimi için varsayılan moddur.

NewForm

NewForm işlevi, Form denetiminin modunu FormMode.New olarak değiştirir. Bu modda, Form denetiminin Item özelliğinin içerikleri yok sayılır ve form, Form denetiminin DataSource özelliğinin varsayılan değerleri ile doldurulur. Form bu moddayken SubmitForm işlevi çalıştırılırsa kayıt oluşturulur, değiştirilmez.

ResetForm

ResetForm işlevi, kullanıcı herhangi bir değişiklik yapmadan önce form içeriklerini ilk değerlerine sıfırlar. Form FormMode.New modundaysa FormMode.Edit moduna sıfırlanır. Form denetiminin OnReset davranışı da çalıştırılır. Ayrıca Reset işleviyle denetimleri bağımsız olarak da sıfırlayabilirsiniz ancak bu işlemi yalnızca formun içinde gerçekleştirebilirsiniz.

ViewForm

ViewForm işlevi, Form denetiminin modunu FormMode.View olarak değiştirir. Bu modda, Form denetiminin Item özelliğinin içerikleri, formun doldurulması için kullanılır. SubmitForm ve ResetForm işlevleri bu modda etkisizdir.

DisplayMode Özelliği

Geçerli mod Mode özelliği aracılığıyla okunabilir. Ayrıca mod, form denetimindeki veri kartları ve denetimler aracılığıyla kullanılabilen DisplayMode özelliğinin değerini de belirler. Genellikle veri kartının DisplayMode özelliği, denetimin DisplayMode özelliği (veri kartına başvuran) gibi, Parent.DisplayMode (forma başvuran) olarak ayarlanır:

Sözdizimi

SubmitForm( FormAdı )

• FormName - Gerekli. Veri kaynağına göndermek için form denetimi.

EditForm( FormAdı )

• FormName - Gerekli. FormMode.Edit moduna geçmek için form denetimi.

NewForm( FormAdı )

• FormName - Gerekli. FormMode.New moduna geçmek için form denetimi.

ResetForm( FormAdı )

• FormName - Gerekli. İlk değerlere sıfırlamak için form denetimi. Ayrıca, FormMode.New modundan FormMode.Edit moduna geçirir.

ViewForm( FormAdı )

• FormName - Gerekli. FormMode.View moduna geçmek için form denetimi.

Örnekler

Tüm örnekler için bkz. Veri formlarını anlama.

1. Button denetimi ekleyin, Text özelliğini Save ifadesini gösterecek şekilde, OnSelect özelliğini ise şu formül olarak ayarlayın:

   SubmitForm( EditForm )

2. Form denetiminin OnFailure özelliğini boş olarak, OnSuccess özelliğini ise şu formül olarak ayarlayın:

   Back()

3. Bir Label denetimini ErrorText olarak adlandırın ve Text özelliğini şu formül olarak ayarlayın:

   EditForm.Error

   Kullanıcı Save düğmesini seçtiğinde, Form denetimindeki tüm değişiklikler temel alınan veri kaynağına gönderilir.

   • Gönderim başarılı olursa tüm değişiklikler kaydedilir veya Form denetimi New modundaysa bir kayıt oluşturulur. ErrorTextboş değerindedir ve önceki ekran yeniden görüntülenir.
   • Gönderim başarısız olursa ErrorText anlaşılması kolay bir hata iletisi gösterir ve geçerli ekran görünmeye devam eder. Böylece kullanıcı, sorunu düzeltip yeniden deneyebilir.

4. Button denetimi ekleyin, Text özelliğini Cancel ifadesini gösterecek şekilde, OnSelect özelliğini ise şu formül olarak ayarlayın:

   ResetForm( EditForm ); Back()

   Kullanıcı Cancel düğmesini seçtiğinde, Form denetimindeki değerler kullanıcı düzeltme yapmaya başlamadan önceki hallerine sıfırlanır, önceki ekran yeniden görüntülenir ve Form denetimi New modundaysa Edit moduna döndürülür.

5. Button denetimi ekleyin,Text özelliğini New modunu gösterecek şekilde, OnSelect özelliğini ise şu formül olarak ayarlayın:

   NewForm( EditForm ); Navigate( EditScreen, None )

   Kullanıcı New düğmesini seçtiğinde, Form denetimi New moduna geçer. Form denetiminin veri kaynağına ilişkin varsayılan değerler ile söz konusu denetim doldurulur ve Form denetimini içeren ekran gösterilir. SubmitForm işlevi çalıştırıldığında yeni bir kayıt oluşturulur (güncelleştirilmez).