Divider
Form üzerinde iki bölümü birbirinden ayıran yatay bir çizgidir. Görsel bir nesnedir; kullanıcıdan veri toplamaz, sadece formu daha düzenli ve okunaklı gösterir.
Değer tipi: Bu nesnenin bir değeri yoktur.
Ne zaman kullanılır?
Uzun bir formu mantıksal bölümlere ayırmak istediğinizde kullanın: "Kişisel Bilgiler" ile "İletişim Bilgileri" arasına bir Divider koyarak iki grubu görsel olarak ayırabilirsiniz. Başlık metni de göstermek isterseniz Divider'ın Title özelliğini kullanabilir ya da Header nesnesini tercih edebilirsiniz. Yalnızca boşluk bırakmak yetiyorsa bir Panel ya da boş alan da işinizi görebilir.
Tasarımcı özellikleri
Bir Divider seçildiğinde Özellik Görüntüleyici iki sekmeye ayrılır. Divider görsel bir nesne olduğu için veri kaynağı ve davranış (Behavior) ayarı yoktur.
General
| Özellik | Açıklama |
|---|---|
Name | Nesnenin koddaki adı (ör. Divider1). Koddan bu adla erişirsiniz. |
Appearance
| Özellik | Açıklama |
|---|---|
Visible | Çizgiyi gösterir veya gizler. |
Client Visible | Sadece tarayıcı tarafında görünürlüğü kontrol eder. |
Enabled | Nesnenin aktif olup olmadığı. |
Client Enabled | Sadece tarayıcı tarafında aktiflik durumu. |
Title | Çizginin üzerinde gösterilecek başlık metni (çok dilli olabilir). Boş bırakılırsa sade bir çizgi görünür. |
Olaylar
Divider görsel bir nesnedir ve kendine ait bir değer olayı yoktur. Yine de her nesne gibi açılış sırasında temel yaşam döngüsü olayları tetiklenir; isterseniz bu olaylara kod yazarak çizgiyi koşullu olarak gösterip gizleyebilirsiniz.
Açılış sırası: OnInit → OnLoad → OnDataLoad → OnPreRender → OnRender
Olaylar iki tarafta çalışabilir: sunucu olayları C# kodunda, istemci olayları tarayıcıdaki TypeScript kodunda.
Sunucu olayları (Server)
| Olay | Ne zaman çalışır |
|---|---|
OnInit | Form açılırken nesne oluşturulduğunda, en başta. |
OnLoad | OnInit'in hemen ardından, nesne yüklenince. |
OnRender | Nesne ekrana çizilirken. |
İstemci olayları (Client)
Sunucudaki olaylara ek olarak tarayıcı tarafında şunlar da vardır:
| Olay | Ne zaman çalışır |
|---|---|
OnDataLoad | Nesnenin verisi yüklendiğinde. |
OnPreRender | Nesne ekrana çizilmeden hemen önce. |
OnClick / OnDoubleClick | Çizgiye tıklanınca / çift tıklanınca. |
OnPropertyChanging / OnPropertyChanged | Bir özellik kodla değiştirilmeden önce / sonra. |
Kod örnekleri
Divider'ın değeri olmadığı için okuma/yazma örnekleri yoktur. Çizgiyi koddan göstermek, gizlemek veya başlığını değiştirmek isterseniz aşağıdaki özellikleri kullanırsınız. Sunucu örnekleri turuncu, istemci örnekleri kırmızı çerçevelidir.
Form kodu (C#, sunucu)
Form kodunda nesneye doğrudan adıyla erişirsiniz:
// Çizgiyi gizle / göster
Divider1.Visible = false;
Divider1.Visible = true;
// Başlık metnini değiştir
Divider1.Title = "İletişim Bilgileri";
Akış (Flow) kodu (C#, sunucu)
Akış kodunda nesneye Document1.Controls üzerinden erişirsiniz:
// Çizgiyi gizle
Document1.Controls["Divider1"].Visible = false;
// Başlık metnini değiştir
Document1.Controls["Divider1"].Title = "İletişim Bilgileri";
İstemci kodu (TypeScript, tarayıcı)
İstemci tarafında nesnelere this. ile erişilir ve özellik adları küçük harfle yazılır (visible, enabled):
this.Divider1.visible = false;
this.Divider1.enabled = true;
Sadece iki bölümü ayırmak istiyorsanız Title alanını boş bırakın; sade bir çizgi yeterli olur. Bölüme bir başlık da vermek istiyorsanız Title yazın ya da daha belirgin bir başlık için Header nesnesini kullanın.
İpuçları
- Divider'ın değeri olmadığı için
Field NameveSizegibi veri ayarları yoktur; veritabanında yer kaplamaz. - Bir bölümü koşullu göstermek istiyorsanız, o bölümün başındaki Divider'ı da aynı koşulla
Visibleyaparak görsel bütünlüğü koruyun. - Çok sayıda Divider yerine, ilgili nesneleri bir Panel içine alıp gruplamak çoğu zaman daha temiz görünür.
Tüm tasarımcı özellikleri (tam liste)
General: Name
Appearance: Visible, Client Visible, Enabled, Client Enabled, Title
Olaylar (Client): OnInit, OnLoad, OnPreRender, OnRender, OnDataLoad, OnClick, OnDoubleClick, OnPropertyChanging, OnPropertyChanged
Olaylar (Server): OnInit, OnLoad, OnRender