dropfiles

Jatuhkan komponen file

Isi

• Keterangan
• Instalasi
• Program demo
• Perbarui riwayat
• Lisensi dan Penafian
• Bug dan permintaan fitur
• Tentang penulis

Keterangan

Tiga komponen disuplai bahwa dukungan dan drop dari Windows Explorer bersama dengan komponen anak perusahaan yang dapat memfilter file yang dijatuhkan. Komponennya adalah:

• TPJDROPFILE - Kontrol kontainer yang menangkap file terseret dan jatuh ke area kliennya atau area klien kontrol anak.
• TPFormDropFiles - Komponen non -visual yang menangkap file diseret dan dijatuhkan dari Explorer ke formulir yang berisi komponen.
• TPJCTRLDROPFILES - Komponen non -visual yang menangkap file diseret dan dijatuhkan dari Explorer ke kontrol terkait.
• TPJEXTFILEFILTER - Komponen filter file yang menyaring file sesuai dengan ekstensi mereka.
• TPJWILDCARDFILEFILTER - Komponen filter file yang menyaring file sesuai dengan kartu liar gaya DOS.
• TPJFileFilter - Kelas dasar abstrak untuk komponen filter file.

Beberapa bantuan waktu desain disediakan oleh editor komponen dan properti.

Fitur utama komponen drop file adalah:

• Acara OnDropFiles dipicu saat file dijatuhkan.
• Nama -nama file yang dijatuhkan tersedia melalui properti array file . Untuk kenyamanan, nama file pertama juga disimpan di properti nama file .
• Daftar file yang dijatuhkan dapat dikonfigurasi untuk memasukkan hanya file, hanya folder atau semua file dan folder.
• Folder yang dijatuhkan dapat dikembalikan sehingga semua file dan sub-folder di masing-masing folder yang dijatuhkan terdaftar.
• Filter dapat diterapkan ke file dan folder yang dijatuhkan. Ini dilakukan dalam salah satu dari dua cara:
  • Dengan menangani acara OnFileFilter dan memutuskan file dan folder mana yang akan melewati filter.
  • Dengan menautkan komponen drop file ke komponen filter file khusus, berasal dari tpjfilefilter abstrak. Dalam hal ini file yang dijatuhkan secara otomatis difilter oleh komponen filter. Dua komponen filter disediakan: TPJEXTFILEFILTER yang menyaring sesuai dengan ekstensi file dan TPJWildCardFileFilter yang memfilter menggunakan kartu liar bergaya DOS. Pengembang dapat membuat komponen filter lebih lanjut dengan berasal dari TPJFileFilter .
• Mouse berkoordinasi di mana file dijatuhkan dapat diambil, seperti halnya referensi ke kontrol apa pun di bawah kursor mouse pada saat itu.
• Acara OnbeforedRop dapat digunakan untuk melakukan pra-pemrosesan sebelum file benar-benar dijatuhkan.
• Properti ISFOLFOLDER Array menginformasikan jika item yang setara di properti File adalah file atau folder.
• Jendela pemilik dapat dibawa ke depan saat file dijatuhkan.

Kesesuaian

Komponen telah diuji pada Delphi 7 to Xe4 Windows Compiler (kecuali Delphi 2005) dan Delphi Xe2 ke Xe4 64 bit kompiler. Komponen -komponen itu dianggap dikompilasi pada kompiler kembali ke Delphi 3, tetapi itu tidak dijamin.

Komponen hanya untuk digunakan dengan VCL: mereka tidak kompatibel dengan firemonkey.

Platform .NET dan non-Windows tidak didukung.

Instalasi

Komponen drop file , dokumentasi mereka dan program demo disediakan dalam file zip. Sebelum menginstal, Anda perlu mengekstrak semua file dari file zip, menjaga struktur direktori. File -file berikut akan diekstraksi:

• PJDropFiles.pas - Kode Sumber Komponen.
• PJDropFiles.dcr - Glyph Palet Komponen.
• PJDropFilesDsgn.pas - Editor Properti dan Kode Sumber Pendaftaran Komponen.
• PJDropFilesDsgn.dfm - Formulir Editor Properti.
• README.md - File ini.
• CHANGELOG.md - Log Perubahan Komponen.
• MPL-2.txt -Lisensi Publik Mozilla v2.0.
• Documentation.URL -Potongan pendek ke dokumentasi online komponen.

Selain file di atas, Anda akan menemukan kode sumber dari dua proyek demo Demo1 dan Demo2 sub-direktori.

Anda sekarang dapat menginstal komponen ke IDE Delphi. Untuk melakukan ini, file PJDropFiles.pas , PJDropFiles.dcr , PJDropFilesDsgn.pas dan PJDropFilesDsgn.dfm harus ditambahkan ke paket waktu desain. Jika Anda membutuhkan bantuan untuk melakukan ini, lihat di sini.

Program demo

Kode sumber untuk dua program demo termasuk dalam unduhan:

1. Program demo utama menjalankan ketiga komponen drop file dan komponen filter.
2. Program yang menunjukkan cara menggunakan tpjctrldropfile dengan bingkai.

Kedua program demo membutuhkan Delphi 7 sebagai minimum. Keduanya kompatibel dengan kompiler Windows Delphi 32 bit dan 64 bit.

Untuk informasi lebih lanjut tentang demo, lihat file README.md di direktori Demos .

Perbarui riwayat

Log perubahan lengkap disediakan di CHANGELOG.md yang termasuk dalam unduhan.

Lisensi dan Penafian

Komponen -komponen ini dirilis berdasarkan ketentuan Lisensi Publik Mozilla v2.0.

Semua merek dagang yang relevan diakui.

Bug dan permintaan fitur

Bug dapat dilaporkan atau fitur baru yang diminta melalui pelacak masalah proyek. Diperlukan akun GitHub.

Silakan periksa apakah masalah telah dibuat untuk laporan atau permintaan serupa. Jika demikian maka silakan tambahkan komentar yang berisi informasi sebanyak mungkin untuk masalah yang ada, atau jika Anda tidak akan menambahkan, cukup tambahkan? ( :+1: Komentar. Jika tidak ada masalah yang ada yang sesuai maka silakan tambahkan masalah baru dan berikan informasi sebanyak mungkin.

Tentang penulis

Saya Peter Johnson - seorang programmer hobi yang tinggal di Ceredigion di Wales Barat, Inggris, menulis terutama di Delphi. Program saya dan kode perpustakaan lainnya tersedia dari: https://delphidabbler.com/.

Dokumen ini adalah Hak Cipta © 2005-2022, PD Johnson.