Image

Formun üzerine bir resim yerleştiren görsel nesnedir. Şirket logosu, bilgilendirme ikonu, ürün fotoğrafı ya da imza görseli gibi sabit veya koddan değiştirilebilen görüntüler için kullanılır.

Bu nesnenin bir değeri yoktur. Image bir görsel nesnedir; veri tutmaz, yalnızca ekranda bir resim gösterir.

Ne zaman kullanılır?

Forma bir resim göstermek istediğinizde kullanın: üst köşeye logo, bir alanın yanına açıklayıcı ikon, ürün kartına fotoğraf. Görseli kullanıcının yükleyeceği bir alan gerekiyorsa Image değil, dosya yükleme nesnesi gerekir. Tıklanınca işlem yapan görsel butonlar için Button daha uygundur.

Tasarımcı özellikleri

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

General

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

Behavior

Resmin kaynağını ve nasıl gösterileceğini bu sekme belirler.

Özellik	Açıklama
SourceType	Resmin nereden geleceğini seçer: dosya adından (FileName) ya da gömülü Base64 verisinden (ImageBase64).
FileName	Gösterilecek resmin dosya adı / yolu. SourceType dosya seçiliyse bu kullanılır.
ImageBase64	Resmin Base64 kodlanmış hali. Resmi forma gömmek isterseniz SourceType Base64 seçilir ve veri buraya yazılır.
Size	Resmin boyutu (genişlik ve yükseklik).
Alt	Resim yüklenemezse görünecek ve ekran okuyucuların okuyacağı alternatif metin (çok dilli olabilir).

Appearance

Özellik	Açıklama
Visible / Client Visible	Nesnenin görünürlüğü. Visible sunucu, Client Visible tarayıcı tarafında geçerlidir.
Enabled / Client Enabled	Nesnenin aktif olup olmadığı.
Title	Fareyle üzerine gelince çıkan ipucu (tooltip) yazısı (çok dilli olabilir).

Olaylar

Bir nesne açılırken olaylar belirli bir sırayla tetiklenir. Image görsel bir nesne 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.

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
OnPreRender	Nesne ekrana çizilmeden hemen önce.
OnClick / OnDoubleClick	Resme tıklanınca / çift tıklanınca.
OnDataLoad	Nesnenin verisi yüklendiğinde.
OnPropertyChanging / OnPropertyChanged	Bir özellik kodla değiştirilmeden önce / sonra.

Kod örnekleri

Image bir değer tutmadığı için .Value ya da .Text kullanılmaz. Görseli koddan değiştirmek için dosya adını, görünürlüğü ve aktifliği ayarlarsı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:

// Resmi gizle / göster
Image1.Visible = false;

// Aktifliği değiştir
Image1.Enabled = true;

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

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

// Resmi gizle
Document1.Controls["Image1"].Visible = false;

İstemci kodu (TypeScript, tarayıcı)

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

// Resmi gizle / göster
this.Image1.visible = false;

// Aktifliği değiştir
this.Image1.enabled = true;

Logo mu, koddan değişen görsel mi?

Hiç değişmeyen bir logo için resmi tasarımda FileName ile sabitleyin; koddan uğraşmanıza gerek kalmaz. Resim duruma göre değişiyorsa (ör. duruma göre yeşil/kırmızı ikon), görseli koddan değiştirmek yerine iki ayrı Image nesnesi koyup Visible ile birini gösterip diğerini gizlemek çoğu zaman daha pratiktir.

İpuçları

• Alt metnini doldurun: resim yüklenemediğinde kullanıcı ne olduğunu görür, ekran okuyucular da bu metni okur.
• Forma gömülü (Base64) resimler form boyutunu büyütür. Sık kullanılan logoları FileName ile dosyadan göstermek daha hafiftir.
• Image tıklanabilir bir görsel buton gibi davranmaz; tıklanınca işlem yaptırmak istiyorsanız OnClick olayını kullanın ya da Button tercih edin.

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

General: Name

Behavior: SourceType, FileName, ImageBase64, Size, Alt

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

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

Olaylar (Server): OnInit, OnLoad, OnRender