CalendarBox

CalendarBox Elemanı; DateBox elemanı ve tarih belirlemede DateBox elemanına yardımcı olmayı hedefleyen bir DHTML takvimden oluşur. Açılan takvim ve DateBox elemanı birbiriyle uyumluluk gösterir ve takvim, DateBox elemanında belirlenmiş özelliklere göre davranır.(Bakınız DateBox) Örneğin DateBox elemanının özelliklerinde belirlenmiş olan "Başlangıç Tarihi" ve "Bitiş Tarihi" değerlerine göre Takvim kendini ayarlar.

Bu eleman ile aslında DateBox elemanı daha yetenekli ve esnek kılınmıştır. Bu sayede takvim ile tarih seçme veya yazı kutusuna klavyeden formata uygun tarih girme gibi avantajlarla ve DateBox - Takvim uyumluluğunun neticesinde tarih kontrolü en üst düzeyde sağlanılabilir.

Takvim diyaloğunun açılması DateBox yazı kutusununun "odak kazanınca" ve aksiyon elemanının ise "Tıklanınca" olaylarına bağlanmıştır. Dilerseniz bu tanımları değiştirebilir veya takvim açma aksiyon elemanında komut düğmesi yerine resim kullanabilirsiniz. Bunun için aksiyon elemanının "Eleman Tipi" özelliğini Image olarak seçin ve "Resim Kaynağı" özelliğinde bir resim belirleyin.

Pencerede açılan takvimin, haftanın günleri sıralamasındaki "ilk gün" belirlenir. Varsayılanı "1. Pazartesi"dir.

Varsayılan "false" değeri "true" olarak belirlenirse takvimde saat gösterilecektir. Bu özellik "true" olarak belirlenirse; DateBox elemanının "Gösterim Biçimi" ve/veya "Gönderim Biçimi" özelliklerinin değerleri saat gösterimine ve/veya gönderimine uygun olmalıdır.

DateBox "Gösterim Biçimi": yyyy.mm.dd hh:nn
DateBox "Gönderim Biçimi": yyyy-mm-dd hh:nn

"Saati Göster" özelliğindeki değere göre belirlenir. Eğer "Saati Göster" "false" ise bu özelliğin bir fonksiyonu olmayacaktır. Eğer takvimde saat gösterilecekse, bu özellikteki "true" değeri ile saat; "24" ayarına göre, "false" değeri "am / pm" ayarına göre gösterilecektir.

"Hafta Numaraları" özelliğinin değeri "true" yapılırsa, takvimin sol tarafında "Hf" başlığı altında tarihlerin yıl içindeki "hafta sıra numaraları" gösterilir.

"Diğer Ayları Göster" özelliğinin değeri "true" yapılırsa, takvimde gösterilen ayın bir önceki ve bir sonraki ayın da bazı tarihleri silik bir stil ile gösterilir. Bu sayede takvimde gösterilen bu silik diğer ay tarihlerini de seçerek; takvim ekranında gösterilen ay değiştirilebilir.

Varsayılan özellik değerinde (true), takvimden bir tarih seçildiğinde takvim kapanır ve seçilen tarih DateBox elemanına atanır. Fakat "Tek Tıklama"nın değeri "false" yapılırsa takvimden seçilen değerin DateBox yazı kutusuna atanması için takvimden seçilecek olan tarihe "2 (iki) defa" tıklamak gerekir.

"Takvim Durum Çubuğu" takvimin en altındaki paneldir ve takvim üzerinde gezinirken fare ile işaret edilen buton,tarih,saat... vb. hakkında bilgi vermeyi amaçlar. Takvimde bir tarihin üzerinde fare ile bekleyince "Durum Çubuğunda" o tarih ile ilgili ayrıntı gösterilir ve gösterilen ayrıntının formatı bu özellikte belirtilen formata göredir. Bu alan boş bırakılırsa varsayılan format devreye girer. Aşağıdaki takvim için "Durum Çubuğu Tarih Formatı" %Y / %B / %A [%j.Gün] olarak belirlenmiştir.

%a	Kısaltılmış gün ismi	%A	Gün ismi
%b	Kısaltılmış ay ismi	%B	Ay ismi
%C	Yüzyıl numarası	%d	Gün ( 00 .. 31 )
%e	Gün ( 0 .. 31 )	%H	Saat ( 00 .. 23 )
%I	Saat ( 01 .. 12 )	%j	Gün sırası ( 000 .. 366 )
%k	Saat ( 0 .. 23 )	%l	Saat ( 1 .. 12 )
%m	Ay ( 01 .. 12 )	%M	Dakika ( 00 .. 59 )
%n	Yeni satır karakteri	%p	``PM'' ya da ``AM''
%P	``pm'' ya da ``am''	%S	Saniye ( 00 .. 59 )
%s	Epoch'dan beri saniye miktarı (Oca 01 1970 00:00:00 UTC'dan beri)	%t	Tab karakteri
%U, %W, %V	Hafta sıra numarası	%u	Gün sıra numarası ( 1 .. 7, 1 = PZT )
%w	Gün sıra numarası ( 0 .. 6, 0 = PAZ )	%y	Yıl, 2Hane ( 00 .. 99 )
%Y	Yıl, 4 Hane ( Ör. 1979 )	%%	Yalın % karakteri

Kullanıcı tarafından takvimden ilgili tarihin seçimi ve/veya oluşturulması esnasında çağrılacak javascript bölümüdür. Bu iki değer alanında, sadece javascript fonksiyonunun adını yazmanız yeterli. Fonksiyon isimlerinden sonra parantez kullanmaya gerek yoktur.

Takvimden bir tarih seçilince çağrılır. Fonksiyona parametre olarak Calendar nesnesi iletilir.

Takvim açılınca, takvim ekranında (penceresinde) beliren ayın her bir günü için, ilgili günün takvimde örülmesinden önce çağrılır. Bu sayede takvimdeki günler belirlenen biçeme göre takvimde vurgulanabilir veya istenilmeyen günler seçilemez hale getirilebilir. Fonksiyon değer olarak true, false veya tanımlanmış bir CSS sınıf adı döndürmelidir.

Daha önce belirtiğimiz gibi Calendar Box sayesinde CalendarBox içinde barınan DateBox elemanı daha esnek ve efektif kullanılabilir. DateBox elemanının "İşlevsel | Salt Okunur" özelliği "true" yapılır ve CalendarBox elemanının "Olay Kotarıcıları | Tarih Durumu" özelliğinde belirtilecek bir fonksiyon ile açılan takvimin hafta sonlarını seçilemez kılmak mümkündür.