CCalendarInputBox - MetaTrader 5 için kütüphane

IncGUI kütüphanesinin yeni CCalendarInputBox kontrolü tarih ve/veya saat girmek için tasarlanmıştır.

• Özel grafik kontroller. Bölüm 1. Basit bir kontrol oluşturma
• Özel grafik kontroller. Bölüm 2. Kontroller Kitaplığı
• Özel grafik kontroller. Bölüm 3. Formlar
  

CCalendarInputBox kontrolü çeşitli modlarda kullanılabilir: tarih ve saat girişi, tarih girişi, saat girişi.

Zaman en yakın dakikaya veya en yakın saniyeye kadar girilebilir (isteğe bağlı). Ayrıca, tarih ve saat dikey çizgi hareket ettirilerek gösterilebilir. Normal durumda öğe, düğmeli bir metin alanını temsil eder. Düğmeye basarsanız bir sekme açılır.

Şekilde, numaralandırılmış kontrollere sahip bir sekme gösterilmektedir.

CCalendarInput kontrolünün açılmış sekmesi

1. Yılı değiştirmek için düğmeler;
2. Ay seçim listesi;
3. Önceki aya gitmek için düğme;
4. Bir sonraki aya gitmek için düğme;
5. Haftanın günlerinin adlarını içeren bilgi çubuğu;
6. Önceki ayın günleri (mevcut ayın günlerine kıyasla daha koyu bir arka plan rengine sahiptirler);
7. Geçerli ayın günü. Geçerli ay, seçilen yılın (1) seçilen ayı (2) anlamına gelir;
8. Seçilen gün;
9. Gerçek geçerli gün;
10. Bir sonraki ayın günleri;
11. Geçerli tarihi ayarlamak için düğme;
12. Gerçek geçerli saati ayarlamak için düğme;
13. Gerçek geçerli tarih;
14. Saat Seçimi;
15. Gerçek geçerli saat;
16. Tarih-saati göstermek için dikey bir çizgiyi etkinleştirme;
17. Yeni bir tarih-saat uygulamadan sekmeyi kapatma;
18. Yeni tarih-saat uygulanarak sekmenin kapatılması.

Kontrolün uygulanması Init() yönteminin çağrılmasıyla başlar, bu yöntem çağrıldığında aşağıdaki parametreler belirtilir:

• string aName="CCalendar" - kontrolün adı;
• bool aDate=true - tarih girişinin kullanılıp kullanılmayacağı;
• bool aTime=true - zaman girişinin kullanılıp kullanılmayacağı;
• bool aSeconds=true - en yakın saniyeye kadar zaman;
• bool aLine=true - dikey çizgi girişinin kullanılıp kullanılmayacağı (tarih ve/veya saat girişine ek olarak);
• int aTimeMode=0 - geçerli saatin türü: 0 - terminal saati, 2 - yerel saat (saat ve tarih şeklin 13. ve 15. konumlarında görüntülenir);
• string aCaption - kontrolün yanındaki yazının metni.
  

Geçerli değerin elde edilmesi ValueDateTime() (datetime formatında) ve ValueString() (string formatında) yöntemleri ile gerçekleştirilir. Zamanın yazılım tarafından ayarlanması SetValueDateTime() metodu ile gerçekleştirilir.

Farklı modlarda (tarih/saat girişi) kontrol, görüntülenen değerin uzunluğuna karşılık gelen farklı bir genişliğe sahiptir, ancak genişlik SetWidth() yöntemi kullanılarak değiştirilebilir. Kontrol, CCalendar (bağımsız olarak kullanılmaz) ve CCalendarInputBox olmak üzere iki sınıf olarak uygulanır. Her iki sınıf da IncGUI_v4.mqh dosyasına eklenmiştir (ekte yer almaktadır).

IncGUIv4mqh.chm dosyası (IncGUI_v4.mqh kütüphanesi için dokümantasyon) doxygen programında hazırlanmıştır ve kontrolün kullanım örneğini içeren uzman eIncGUI_v4_Test_CCalendarInputBox.mq5 ekte yer almaktadır.