CCalendarInputBox - libreria per MetaTrader 5

Il nuovo controllo CCalendarInputBox della libreria IncGUI è progettato per inserire la data e/o l'ora.

• Controlli grafici personalizzati. Parte 1. Creazione di un semplice controllo
• Controlli grafici personalizzati. Parte 2. Libreria di controlli
• Controlli grafici personalizzati. Parte 3. Moduli
  

Il controllo CCalendarInputBox può essere utilizzato in varie modalità: inserimento di data e ora, inserimento di data, inserimento di ora.

L'ora può essere inserita al minuto più vicino o al secondo più vicino (opzionale). Inoltre, la data e l'ora possono essere indicate spostando la linea verticale. Nello stato normale, l'elemento rappresenta un campo di testo con un pulsante. Se si preme il pulsante, si apre una scheda.

La figura mostra una scheda con controlli numerati.

Scheda aperta del controllo CCalendarInput

1. Pulsanti per cambiare l'anno;
2. Elenco di selezione dei mesi;
3. Pulsante per passare al mese precedente;
4. Pulsante per passare al mese successivo;
5. Barra informativa con i nomi dei giorni della settimana;
6. Giorni del mese precedente (hanno un colore di sfondo più scuro rispetto ai giorni del mese corrente);
7. Giorno del mese corrente. Per mese corrente si intende il mese selezionato (2) dell'anno selezionato (1);
8. Giorno selezionato;
9. Il giorno attuale;
10. Giorni del mese successivo;
11. Tasto per impostare la data attuale;
12. Tasto per impostare l'ora attuale;
13. Data corrente effettiva;
14. Selezione dell'ora;
15. Ora attuale;
16. Abilitazione di una linea verticale per indicare la data e l'ora;
17. Chiusura della scheda senza applicare una nuova data-ora;
18. Chiusura della scheda con l'applicazione della nuova data-ora.

L'applicazione del controllo inizia con una chiamata al metodo Init(), al quale vengono specificati i seguenti parametri:

• string aName="CCalendar" - il nome del controllo;
• bool aDate=true - se viene utilizzato l'input della data;
• bool aTime=true - se viene utilizzato l'input dell'ora;
• bool aSeconds=true - tempo al secondo più vicino;
• bool aLine=true - se viene utilizzato l'input della linea verticale (oltre all'input della data e/o dell'ora);
• int aTimeMode=0 - tipo di ora corrente: 0 - ora del terminale, 2 - ora locale (ora e data visualizzate nelle posizioni 13 e 15 della figura);
• string aCaption - testo dell'iscrizione accanto al controllo.
  

L'ottenimento del valore corrente viene eseguito dai metodi ValueDateTime() (in formato datetime) e ValueString() (in formato stringa). L'impostazione software dell'ora viene eseguita dal metodo SetValueDateTime().

In diverse modalità (input data/ora) il controllo ha una larghezza diversa che corrisponde alla lunghezza del valore visualizzato, ma la larghezza può essere modificata con il metodo SetWidth(). Il controllo è implementato come due classi CCalendar (non utilizzata indipendentemente) e CCalendarInputBox. Entrambe le classi sono aggiunte al file IncGUI_v4.mqh (che si trova in appendice).

Il file IncGUIv4mqh.chm (documentazione per la libreria IncGUI_v4.mqh) preparato nel programma doxygen e l'esperto eIncGUI_v4_Test_CCalendarInputBox.mq5 con un esempio di utilizzo del controllo si trovano in appendice.