CCalendarInputBox - bibliothèque pour MetaTrader 5

Le nouveau contrôle CCalendarInputBox de la bibliothèque IncGUI est conçu pour saisir la date et/ou l'heure.

• Contrôles graphiques personnalisés. Partie 1. Création d'un contrôle simple
• Contrôles graphiques personnalisés. Partie 2. Bibliothèque de contrôles
• Contrôles graphiques personnalisés. Partie 3. Formulaires
  

Le contrôle CCalendarInputBox peut être utilisé dans différents modes : saisie de la date et de l'heure, saisie de la date, saisie de l'heure.

L'heure peut être saisie à la minute ou à la seconde près (optionnel). En outre, la date et l'heure peuvent être indiquées en déplaçant la ligne verticale. Dans son état normal, l'élément représente un champ de texte avec un bouton. Si vous appuyez sur le bouton, un onglet s'ouvre.

L'illustration montre un onglet avec des contrôles numérotés.

Onglet ouvert du contrôle CCalendarInput

1. Boutons pour changer l'année ;
2. Liste de sélection des mois ;
3. Bouton pour aller au mois précédent ;
4. Bouton pour passer au mois suivant ;
5. Barre d'information avec les noms des jours de la semaine ;
6. Jours du mois précédent (ils ont une couleur de fond plus foncée que les jours du mois en cours) ;
7. Jour du mois en cours. Le mois en cours signifie le mois sélectionné (2) de l'année sélectionnée (1) ;
8. Jour sélectionné ;
9. Le jour actuel ;
10. Jours du mois suivant ;
11. Bouton de réglage de la date actuelle ;
12. Bouton de réglage de l'heure actuelle ;
13. Date actuelle ;
14. Sélection de l'heure ;
15. Heure actuelle ;
16. Activation d'une ligne verticale pour indiquer la date et l'heure ;
17. Fermeture de l'onglet sans application d'une nouvelle date-heure ;
18. Fermeture de l'onglet avec application de la nouvelle date et heure.

L'application du contrôle commence par un appel à la méthode Init(), dont les paramètres suivants sont spécifiés lors de l'appel :

• string aName="CCalendar" - le nom du contrôle ;
• bool aDate=true - indique si la saisie de la date est utilisée ;
• bool aTime=true - si la saisie de l'heure est utilisée ;
• bool aSeconds=true - l'heure à la seconde près ;
• bool aLine=true - indique si la saisie de la ligne verticale est utilisée (en plus de la saisie de la date et/ou de l'heure) ;
• int aTimeMode=0 - type d'heure actuelle : 0 - heure du terminal, 2 - heure locale (heure et date affichées aux positions 13 et 15 de la figure) ;
• string aCaption - texte de l'inscription à côté du contrôle.
  

L'obtention de la valeur courante est réalisée par les méthodes ValueDateTime() (au format datetime) et ValueString() (au format string). Le réglage logiciel de l'heure est effectué par la méthode SetValueDateTime().

Dans les différents modes (saisie de la date et de l'heure), le contrôle a une largeur différente correspondant à la longueur de la valeur affichée, mais la largeur peut être modifiée à l'aide de la méthode SetWidth(). Le contrôle est implémenté sous la forme de deux classes : CCalendar (non utilisée indépendamment) et CCalendarInputBox. Ces deux classes sont ajoutées au fichier IncGUI_v4.mqh (situé en annexe).

Le fichier IncGUIv4mqh.chm (documentation pour la bibliothèque IncGUI_v4.mqh) préparé dans le programme doxygen et l'expert eIncGUI_v4_Test_CCalendarInputBox.mq5 avec un exemple d'utilisation du contrôle sont situés dans l'annexe.