Ana içeriğe geç

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

ÖzellikAçıklama
NameNesnenin koddaki adı (ör. Divider1). Koddan bu adla erişirsiniz.

Appearance

ÖzellikAçıklama
VisibleÇizgiyi gösterir veya gizler.
Client VisibleSadece tarayıcı tarafında görünürlüğü kontrol eder.
EnabledNesnenin aktif olup olmadığı.
Client EnabledSadece 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ı: OnInitOnLoadOnDataLoadOnPreRenderOnRender

Olaylar iki tarafta çalışabilir: sunucu olayları C# kodunda, istemci olayları tarayıcıdaki TypeScript kodunda.

Sunucu olayları (Server)

OlayNe zaman çalışır
OnInitForm açılırken nesne oluşturulduğunda, en başta.
OnLoadOnInit'in hemen ardından, nesne yüklenince.
OnRenderNesne ekrana çizilirken.

İstemci olayları (Client)

Sunucudaki olaylara ek olarak tarayıcı tarafında şunlar da vardır:

OlayNe zaman çalışır
OnDataLoadNesnenin verisi yüklendiğinde.
OnPreRenderNesne ekrana çizilmeden hemen önce.
OnClick / OnDoubleClickÇizgiye tıklanınca / çift tıklanınca.
OnPropertyChanging / OnPropertyChangedBir ö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;
Başlık mı çizgi mi?

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 Name ve Size gibi 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 Visible yaparak 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