eCalendario

Vous pouvez lire ce Readme.md en anglais si vous le souhaitez en cliquant ici.

Description: composant Delphi FiremonKey qui peut être facilement implémenté sur toutes les plates-formes que FiremonKey Framework Compila (Windows 32-bits, Windows 64 bits, macOS, IOS, Linux, Android). L'objectif est d'être un calendrier simple à mettre en œuvre dans l'exécution (ce composant ne fonctionne pas en temps de conception).

Fonctionnalité

• Composant créé dans Runtime;
• Utilise le concept d'interfaces;
• Il est personnalisable;
• Il a des animations et peut être personnalisé de manière simple
• Il prend en charge deux langues (portugais et anglais);
• Inutile d'installer le package, ajoutez simplement unité ou utilisez le boss pour gérer les installations (recommandées);
• Le composant sera constamment mis à jour pour apporter de nouvelles fonctionnalités et fixe;
• Simple à utiliser.

Comment commencer à utiliser le composant

Pour commencer à utiliser ECALENDAR, vous n'avez besoin que d'unité ealendario.component.pas et ealendario.component.fmx. Vous pouvez télécharger le code zip (ou même la version qui est plus recommandée) et ajouter à votre projet ou utiliser Boss, avec les commandes ci-dessous:

Pour démarrer le projet (créer un fichier boss.json et pouvoir contrôler les installations)

Boss init

Pour installer l'Ealendario comme dépendance

Boss install https://github.com/rafael-figueiredo-alves/eCalendario

Ensuite, utilisez simplement le code de la section ci-dessous pour utiliser et n'oubliez pas de déclarer unité eCalendario.component.pas dans les utilisations où vous souhaitez utiliser le calendrier.

Comment mettre l'Ealendario sur votre formulaire de projet

La première chose à faire pour pouvoir utiliser l'Ealendario sur l'un de vos formulaires de projet est de mettre une forme sur forme avec les propriétés de hauteur d'au moins 340 et une largeur d'au moins 300 .

Maintenant, lors de l'événement onCreate (il peut également être sur onShow ), vous devez utiliser les commandes suivantes dans l'ordre suivant:

TeCalendario.New( formulaire auquel le calendrier sera lié , disposition où le calendrier sera rendu )

Cette commande sert à créer l'Ealendarium, appelant la classe (qui est une interface) Tecalendario et appelant la nouvelle méthode (qui créera une instance de classe), où nous définirons deux paramètres: le formulaire où le calendrier sera utilisé et le TLayout où il sera rendu.

onClickDate( fonction à déclencher lorsque vous cliquez un jour ou lors de la modification des mois et des années dans le calendrier )

Cette commande doit venir après la création pour associer la méthode (action) qui sera utilisée lorsque nous modifierons la date, que ce soit en cliquant un jour, en modifiant le mois ou l'année. Le paramètre doit être une function avec la signature suivante: function nome_da_função (Data: TDate);

Locale( accepte les valeurs: ptbr | en | spanol | fr | it | ger )

La commande des paramètres régionaux est utilisée pour définir la langue du calendrier. Il y a six possibilités:

• PTBR - pour définir le calendrier dans la langue portugaise;
• En - Définir le calendrier en anglais.
• Espagnol - pour définir le calendrier en langue espagnole
• Fr - Définir le calendrier dans la langue française.
• Il - pour définir le calendrier dans la langue italienne.
• Ger - Définir le calendrier dans la langue allemande.

StartDate( accepte une valeur du tdate ou de l'adatetime, comme maintenant () )

StartDate est utilisé pour définir la date actuelle (aujourd'hui) ou la date qui doit être sélectionnée par défaut. Il devrait recevoir un paramètre au format adate ou adatetime.

ShowCalendar;

C'est cette dernière commande qui exécute la magie de l'affichage d'un calendrier sur notre forme dans la mise en page définie dans la New méthode. Voir ci-dessous un exemple de code pour utiliser l'Ealendario en utilisant ce qui a été présenté:

 procedure TFormMain.FormCreate (Sender: TObject);
begin
  teCalendario.New(self, Layout1)
                .onClickDate(ExibeData)
                .Locale(ptBr)
                .StartDate(Now)
                .ShowCalendar;
end ;

procedure TFormMain.ExibeData (Data: TDate);
begin
  Label1.Text := DateToStr(Data);
end ;

Configuration du calendrier

Si vous souhaitez personnaliser le calendrier, vous pouvez modifier directement au fichier eCalendario.component.fmx ou le code suivant peut être utilisé:

                .config
                  .BackgroundColor(talphaColors.Yellow)
                  .SundaysColor(talphacolors.Red)
                  .SelectorColor(TAlphaColors.Blue)
                  .DaysColor(TAlphaColors.Blue)
                  .LineColor(TAlphaColors.Blue)
                  .MonthYearColor(TAlphaColors.Blue)
                  .ButtonsColor(TAlphaColors.Blue)                  
                  .& End

La commande Config vous permet d'ouvrir les options d'édition. Dans BackgroundColor() , vous définissez la couleur d'arrière-plan du calendrier (qui est blanc par défaut), et le paramètre à utiliser doit être de type Talphacolors. La commande SundaysColor() est responsable de la définition de la couleur des dimanches sur le calendrier (qui est par défaut bleu). Acceptez le paramètre de type Talphacolors. La commande SelectorColor() est responsable de la définition de la couleur du sélecteur et de l'acceptation de se distancier à Talphacolors. Pour définir la couleur de la ligne, les boutons, le nom du mois et de l'année utilisent les commandes respectives: LineColor() , MonthYearColor() , ButtonsColor() . Pour définir la couleur des jours, à l'exception des dimanches, utilisez la commande DaysColor() . Toutes ces commandes s'attendent à un paramètre de type Talphacolors. La commande &End sort de l'interface de configuration et revient à la principale. Voir l'extrait de code ci-dessous avec l'ajout d'une simple personnalisation:

 procedure TFormMain.FormCreate (Sender: TObject);
begin
  teCalendario.New(self, Layout1)
                .onClickDate(ExibeData)
                .Locale(ptBr)
                .StartDate(Now)
                .config
                  .BackgroundColor(talphaColors.Yellow)
                  .SundaysColor(talphacolors.Red)
                  .& End
                .ShowCalendar;
end ;

Vous voulez aider?

Votre contribution est la bienvenue, que ce soit une identification d'erreur (problème) ou une demande de traction. N'hésitez pas à contribuer. Si vous le souhaitez, vous seriez heureux si vous pouvez faire connaître ce travail à d'autres personnes.

Rafael de Figueiredo Alves