Header

Form üzerinde bölüm başlığı göstermek için kullanılan görsel nesnedir. Formu mantıklı bölümlere ayırır ve kullanıcıya hangi alanın ne işe yaradığını anlatır.

Değer tipi: Bu nesnenin bir değeri yoktur. Header yalnızca ekranda yazı gösterir; veri tutmaz, veritabanına bir şey kaydetmez.

Ne zaman kullanılır?

Uzun bir formu "Kişisel Bilgiler", "İletişim", "Onay" gibi parçalara ayırmak istediğinizde kullanın. Tek satırlık küçük bir açıklama yazısı için Label, yatay ayraç için Divider daha uygundur. Header daha büyük ve dikkat çeken bir bölüm başlığıdır.

Tasarımcı özellikleri

Bir Header seçildiğinde Özellik Görüntüleyici sekmelere ayrılır.

General

Özellik	Açıklama
Name	Nesnenin koddaki adı (ör. Header1). Koddan bu adla erişirsiniz.
Text	Başlıkta görünen yazı (çok dilli olabilir).

Behavior

Özellik	Açıklama
HeadingType	Başlık düzeyi (ör. h1, h2, h3). Düzey küçüldükçe yazı küçülür.
Font	Yazı tipi, kalın / italik / altı çizili.
Height	Başlığın yüksekliği (piksel).
LineHeight	Satır yüksekliği; çok satırlı başlıkta satır aralığını ayarlar.
ReadOnly	Salt okunur. Header için zaten yazı girişi olmadığından nadiren değişir.
Required	Zorunluluk işareti. Değer tutmayan bu nesnede pratikte etkisizdir.
Tab Index	Tab tuşuyla geçiş sırasını belirler.

Appearance

Özellik	Açıklama
Visible / Client Visible	Nesnenin görünürlüğü.
Enabled / Client Enabled	Nesnenin aktif olup olmadığı.
Text	Başlık yazısı (çok dilli).
Title	Fareyle üzerine gelince çıkan ipucu (tooltip) yazısı.
Text Align	Yazının yatay hizası (sola / ortaya / sağa).

Olaylar

Bir nesne açılırken olaylar belirli bir sırayla tetiklenir. Header değer tutmadığı için değer olayları pratikte nadir kullanılır; çoğunlukla açılış olayları yeterlidir.

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.
OnValidating	Form doğrulanırken çalışan denetim olayı.
OnValueChanging	Değer kodla değiştirilmeden hemen önce (iptal edilebilir).
OnValueChanged	Değer kodla değiştirildikten hemen sonra.

İ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	Başlığa tıklanınca / çift tıklanınca.
OnPropertyChanging / OnPropertyChanged	Bir özellik kodla değiştirilmeden önce / sonra.

Kod örnekleri

Header değer tutmadığı için ona genellikle başlık yazısını okumak/değiştirmek ya da görünürlüğünü kontrol etmek için erişirsiniz. Sunucu örnekleri turuncu, istemci örnekleri kırmızı çerçevelidir.

Form kodu (C#, sunucu)

Form kodunda nesneye doğrudan adıyla erişirsiniz:

// Başlık yazısını değiştir
Header1.Text = "Kişisel Bilgiler";

// Gizle / göster
Header1.Visible = false;

Akış (Flow) kodu (C#, sunucu)

Akış kodunda nesneye Document1.Controls üzerinden erişirsiniz:

// Başlık yazısını değiştir
Document1.Controls["Header1"].Text = "Onay Adımı";

// Gizle / göster
Document1.Controls["Header1"].Visible = false;

İstemci kodu (TypeScript, tarayıcı)

İstemci tarafında nesnelere this. ile erişilir ve özellik adları küçük harfle yazılır:

// Başlık yazısını değiştir
this.Header1.text = "İletişim Bilgileri";

// Gizle / göster
this.Header1.visible = false;

Değeri yok, yazısı var

Header bir veri nesnesi değildir; .Value yoktur. Ekrandaki yazıyı değiştirmek için .Text, ipucu için .Title kullanın. Onay adımına göre başlığı değiştirmek istiyorsanız bu özellikleri koddan set edebilirsiniz.

İpuçları

• Formu okunabilir tutmak için her bölümün başına bir Header koyun; kullanıcı uzun formda nerede olduğunu kolayca anlar.
• HeadingType ile başlık düzeyini seçin: ana bölümler için büyük (h1/h2), alt başlıklar için daha küçük (h3) kullanın.
• Header veri tutmadığı için Field Name ve Size gibi alanları yoktur; veritabanına bir şey yazmaz.
• Akış adımına göre değişen başlıklar için Text özelliğini koddan güncelleyin (ör. "Talep Oluşturma" / "Onay Bekliyor").

Tüm tasarımcı özellikleri (tam liste)

General: Name, Text

Behavior: HeadingType, Font, Height, LineHeight, ReadOnly, Required, Tab Index

Appearance: Visible, Client Visible, Enabled, Client Enabled, Text, Title, Label, Text Align

Olaylar (Server): OnInit, OnLoad, OnRender, OnValidating, OnValueChanging, OnValueChanged

Olaylar (Client): OnInit, OnLoad, OnPreRender, OnRender, OnDataLoad, OnClick, OnDoubleClick, OnPropertyChanging, OnPropertyChanged, OnValueChanging, OnValueChanged