eCalendario

Anda dapat membaca readme.md ini dalam bahasa Inggris jika Anda mau dengan mengklik di sini.

Deskripsi: Komponen Delphi Firemonkey yang dapat dengan mudah diimplementasikan pada semua platform yang Firemonkey Framework Compila (Windows 32-bit, Windows 64-bit, MacOS, iOS, Linux, Android). Tujuannya adalah untuk menjadi kalender sederhana untuk diterapkan dalam runtime (komponen ini tidak berfungsi dalam waktu desain).

Fitur

• Komponen dibuat dalam runtime;
• Menggunakan konsep antarmuka;
• Itu dapat disesuaikan;
• Ini memiliki animasi dan dapat disesuaikan dengan cara yang sederhana
• Ini memiliki dukungan untuk dua bahasa (Portugis dan Inggris);
• Tak perlu menginstal paket, cukup tambahkan unit atau gunakan bos untuk mengelola fasilitas (disarankan);
• Komponen akan terus diperbarui untuk membawa fitur baru dan diperbaiki;
• Mudah digunakan.

Cara Mulai Menggunakan Komponen

Untuk mulai menggunakan Ecalendar, Anda hanya perlu unit ecalendario.component.pas dan ecalendario.component.fmx. Anda dapat mengunduh ZIP kode (atau bahkan rilis yang lebih disarankan) dan menambah proyek Anda atau menggunakan bos, dengan perintah di bawah ini:

Untuk memulai proyek (buat file boss.json dan dapat mengontrol fasilitas)

Boss init

Untuk menginstal ecalendario sebagai ketergantungan

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

Kemudian cukup gunakan kode bagian di bawah ini untuk digunakan dan tidak lupa untuk mendeklarasikan unit ecalendario.component.pas di penggunaan di mana Anda ingin menggunakan kalender.

Cara menempatkan ecalendario pada formulir proyek Anda

Hal pertama yang harus dilakukan untuk dapat menggunakan ecalendario pada salah satu bentuk proyek Anda adalah dengan menempatkan tlayout pada bentuk dengan sifat ketinggian setidaknya 340 dan lebar minimal 300 .

Sekarang, di acara onCreate (mungkin juga ada di onShow ), Anda harus menggunakan perintah berikut dalam urutan berikut:

TeCalendario.New( bentuk kalender mana akan ditautkan , tata letak di mana kalender akan diterjemahkan )

Perintah ini berfungsi untuk membuat tecalendario ecalendarium, memanggil kelas (yang merupakan antarmuka) tecalendario dan memanggil metode baru (yang akan membuat instance kelas), di mana kita akan mendefinisikan dua parameter: formulir di mana kalender akan digunakan, dan tlayout di mana akan diterjemahkan.

onClickDate( Fungsi untuk dipicu saat mengklik pada hari atau saat mengubah bulan dan tahun di kalender )

Perintah ini harus dilakukan setelah pembuatan untuk mengaitkan metode (tindakan) yang akan digunakan ketika kita mengubah tanggal, apakah dengan mengklik satu hari, mengubah bulan atau tahun. Parameter harus berupa function dengan tanda tangan berikut: function nome_da_função (Data: TDate);

Locale( menerima nilai: ptbr | en | spanol | fr | it | ger )

Perintah lokal digunakan untuk mendefinisikan bahasa kalender. Ada enam kemungkinan:

• PTBR - Untuk mendefinisikan kalender dalam bahasa Portugis;
• En - untuk mendefinisikan kalender dalam bahasa Inggris.
• Spanyol - Untuk mendefinisikan kalender dalam bahasa Spanyol
• FR - Untuk mendefinisikan kalender dalam bahasa Prancis.
• Itu - untuk mendefinisikan kalender dalam bahasa Italia.
• GER - Untuk mendefinisikan kalender dalam bahasa Jerman.

StartDate( menerima nilai tdate atau adatetime, seperti sekarang () )

StartDate digunakan untuk mengatur tanggal saat ini (hari ini) atau tanggal yang harus dipilih secara default. Itu harus menerima parameter dalam format Adate atau Adatetime.

ShowCalendar;

Perintah terakhir inilah yang melakukan keajaiban menampilkan kalender pada formulir kami di dalam tata letak yang ditentukan dalam metode New . Lihat di bawah contoh kode untuk menggunakan ecalendario menggunakan apa yang disajikan:

 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 ;

Mengkonfigurasi Kalender

Jika Anda ingin menyesuaikan kalender, Anda dapat mengedit langsung ke file ecalendario.component.fmx atau kode berikut dapat digunakan:

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

Perintah Config memungkinkan Anda untuk membuka opsi pengeditan. Di BackgroundColor() , Anda mengatur warna latar belakang kalender (yang putih secara default), dan parameter yang akan digunakan harus tipe Talphacolors. Perintah SundaysColor() bertanggung jawab untuk mendefinisikan warna hari Minggu di kalender (yang secara default berwarna biru). Terima parameter tipe Talphacolors. Perintah SelectorColor() bertanggung jawab untuk mengatur warna pemilih dan menerima jarak jauh di Talphacolors. Untuk mengatur warna garis, tombol, nama bulan dan tahun menggunakan perintah masing -masing: LineColor() , MonthYearColor() , ButtonsColor() . Untuk menentukan warna hari, kecuali untuk hari Minggu, gunakan perintah DaysColor() . Semua perintah ini mengharapkan parameter tipe Talphacolors. Perintah &End keluar dari antarmuka konfigurasi dan kembali ke yang utama. Lihat kutipan kode di bawah ini dengan penambahan kustomisasi sederhana:

 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 ;

Ingin membantu?

Kontribusi Anda sangat diterima, apakah identifikasi kesalahan (masalah) atau permintaan tarik. Jangan ragu untuk berkontribusi. Jika diinginkan, Anda akan senang jika Anda dapat mempublikasikan pekerjaan ini kepada orang lain.

Rafael de figueiredo alves