ScrollView

İçine yerleştirilen nesneleri kaydırılabilir bir alanda taşıyan yerleşim nesnesidir. Alana sığmayan içerik olduğunda kaydırma çubuğu çıkar, böylece kullanıcı içeriği yukarı aşağı (veya yana) kaydırarak görür. Tek başına bir veri tutmaz; görevi içeriği belirli bir alanda toplayıp kaydırmaktır.

Bu nesnenin bir değeri yoktur. ScrollView bir kapsayıcı (container) nesnedir; ekranda kendi başına veri göstermez, içine koyduğunuz nesneleri kaydırılabilir bir çerçevede taşır.

Ne zaman kullanılır?

Sınırlı bir alana çok sayıda nesne ya da uzun bir liste sığdırmanız gerektiğinde kullanılır: uzun bir form bölümü, çok satırlı bir kart listesi, dar bir yan panel. İçerik alana sığmadığında kaydırma çubuğu otomatik gelir. Sabit yükseklik gerektirmeyen genel gruplamalar için Panel, katlanabilir bölümler için Section, sekmeli düzen için Tabs daha uygundur.

Tasarımcı özellikleri

Bir ScrollView seçildiğinde Özellik Görüntüleyici sekmelere ayrılır. ScrollView bir yerleşim nesnesi olduğu için davranış ve görünüm ayarları sadedir.

General

Özellik	Açıklama
Name	Nesnenin koddaki adı (ör. ScrollView1). Koddan bu adla erişirsiniz.

Behavior

Özellik	Açıklama
ReadOnly	Alanı salt okunur yapar; içindeki nesnelere değer girilemez.
ScrollViewItems	Kaydırılabilir alana eklenen öğelerin listesi. Her öğe bu liste üzerinden tanımlanır.

Appearance

Özellik	Açıklama
Visible	Nesneyi gösterir veya gizler.
Client Visible	Sadece tarayıcı tarafında görünürlüğü yönetir.
Enabled	Nesnenin aktif olup olmadığı; pasifken içindeki nesneler kullanılamaz.
Client Enabled	Sadece tarayıcı tarafında aktifliği yönetir.
Title	Nesnenin başlığı (çok dilli olabilir).

Olaylar

Bir nesne açılırken olaylar belirli bir sırayla tetiklenir. ScrollView bir yerleşim nesnesi olduğu için kendine ait değer olayı yoktur; yalnızca yaşam döngüsü olayları çalışır.

Açılış sırası: OnInit → OnLoad → OnPreRender → OnRender

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

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

Kod örnekleri

ScrollView'un değeri olmadığı için ondan değer okunmaz; bunun yerine görünürlüğünü ve aktifliğini kodla yönetirsiniz. Sunucu örnekleri turuncu, istemci örnekleri kırmızı çerçevelidir.

Form kodu (C#, sunucu)

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

// Kaydırılabilir alanı gizle veya göster
ScrollView1.Visible = false;

// Alanı pasifleştir (içindeki nesneler kullanılamaz)
ScrollView1.Enabled = false;

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

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

// Kaydırılabilir alanı gizle
Document1.Controls["ScrollView1"].Visible = false;

// Alanı pasifleştir
Document1.Controls["ScrollView1"].Enabled = false;

İstemci kodu (TypeScript, tarayıcı)

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

// Kaydırılabilir alanı gizle veya göster
this.ScrollView1.visible = false;

// Alanı pasifleştir
this.ScrollView1.enabled = false;

ScrollView değer tutmaz

ScrollView'a .Value ile değer yazmaya çalışmayın; bu nesnenin değeri yoktur. Veri girişi için ScrollView'un içine TextBox, ComboBox gibi nesneler yerleştirin. ScrollView yalnızca onları kaydırılabilir bir alanda taşır.

İpuçları

• ScrollView'u dar bir alana çok sayıda nesne sığdırmak için kullanın; içerik taşınca kaydırma çubuğu kendiliğinden gelir.
• Tüm alanı birden gizlemek için tek tek nesneleri değil, doğrudan ScrollView'un Visible özelliğini değiştirin. İçindeki tüm nesneler birlikte gizlenir.
• ScrollView'u koşula göre göstermek için OnLoad olayında Visible özelliğini ayarlayın.

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

General: Name

Behavior: ReadOnly, ScrollViewItems (List<ScrollViewItem>)

Appearance: Visible, Client Visible, Enabled, Client Enabled, Title

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

Olaylar (Server): OnInit, OnLoad, OnRender