dropfiles

ファイルコンポーネントをドロップします

コンテンツ

• 説明
• インストール
• デモプログラム
• 履歴を更新します
• ライセンスと免責事項
• バグと機能リクエスト
• 著者について

説明

Windows Explorerからのドラッグアンドドロップと、ドロップされたファイルをフィルタリングできる子会社コンポーネントをサポートする3つのコンポーネントが提供されています。コンポーネントは次のとおりです。

• TPJDROPFILES-クライアント領域またはクライアントエリアにドラッグしてドラッグされたファイルをキャッチするコンテナ制御。
• TPFormDropFiles-エクスプローラーからドラッグされてドロップされたファイルをキャッチする非視覚コンポーネントは、コンポーネントを含むフォームにドロップします。
• TPJCTRLDROPFILES-エクスプローラーからドラッグされ、関連するコントロールにドラッグされてドロップされたファイルをキャッチする非視覚コンポーネント。
• tpjextFilefilter-拡張機能に応じてファイルをフィルターするファイルフィルターコンポーネント。
• TPJWildCardFilefilter- DOSスタイルのワイルドカードに従ってファイルをフィルターするファイルフィルターコンポーネント。
• TPJFILEFILTER-ファイルフィルターコンポーネントの抽象的なベースクラス。

一部の設計時間支援は、コンポーネントとプロパティエディターによって提供されます。

ドロップファイルコンポーネントの主な機能は次のとおりです。

• ファイルがドロップされたときに、 OndropFilesイベントがトリガーされます。
• ドロップされたファイルの名前は、ファイル配列プロパティを介して利用可能になります。便利なため、最初のファイルの名前はFilenameプロパティにも保存されます。
• ドロップされたファイルのリストは、ファイルのみ、フォルダーまたはすべてのファイルとフォルダーのみを含めるように構成できます。
• ドロップされたフォルダーは、ドロップされた各フォルダーのすべてのファイルとサブフォルダーがリストされるように再挿入できます。
• フィルターは、ドロップされたファイルとフォルダーに適用できます。これは、2つの方法のいずれかで行われます。
  • onfilefilterイベントを処理し、フィルターを通過するファイルとフォルダーを決定します。
  • ドロップファイルコンポーネントを抽象TPJFilefilterから派生した特別なファイルフィルターコンポーネントにリンクします。この場合、ドロップされたファイルはフィルターコンポーネントによって自動的にフィルタリングされます。 2つのフィルターコンポーネントが提供されています。ファイル拡張機能に従ってフィルターをかけるTPJExtFileFilterと、DOSスタイルのワイルドカードを使用してフィルターを使用するTPJWildCardFilefilter 。開発者は、 TPJFilefilterから派生することにより、さらにフィルターコンポーネントを作成できます。
• 当時のマウスカーソルの下での任意のコントロールへの参照と同様に、ファイルをドロップしたマウスの座標を取得できます。
• onbeforedropイベントは、ファイルが実際に削除される前に、前処理を行うために使用できます。
• IsFolderアレイプロパティは、ファイルプロパティの同等のアイテムがファイルまたはフォルダーであるかどうかを通知します。
• ファイルがドロップされると、所有ウィンドウを前面に持ち込むことができます。

互換性

コンポーネントは、Delphi 7からXe4 Windowsコンパイラ（Delphi 2005を除く）とXE4からXE4 64ビットコンパイラでテストされています。コンポーネントは、デルファイ3に戻るコンパイラにコンパイルすると考えられていますが、それは保証されていません。

コンポーネントは、VCLのみで使用するためのものです。それらはFireMonkeyと互換性がありません。

.NETおよび非ワインドプラットフォームはサポートされていません。

インストール

ドロップファイルコンポーネント、ドキュメント、デモプログラムはzipファイルに提供されます。インストールする前に、zipファイルからすべてのファイルを抽出し、ディレクトリ構造を保存する必要があります。次のファイルが抽出されます。

• PJDropFiles.pas - コンポーネントソースコード。
• PJDropFiles.dcr - コンポーネントパレットグリフ。
• PJDropFilesDsgn.pas - プロパティエディターとコンポーネント登録ソースコード。
• PJDropFilesDsgn.dfm - プロパティエディターフォーム。
• README.md - このファイル。
• CHANGELOG.md - コンポーネントの変更ログ。
• MPL-2.txt - The Mozilla Public License v2.0。
• Documentation.URL - コンポーネントのオンラインドキュメントのショートカット。

上記のファイルに加えて、2つのデモプロジェクトのソースコードがDemo1とDemo2サブディレクトリを見つけます。

これで、コンポーネントをDelphi IDEにインストールできます。これを行うには、ファイルPJDropFiles.pas 、 PJDropFiles.dcr 、 PJDropFilesDsgn.pas 、 PJDropFilesDsgn.dfmを設計時間パッケージに追加する必要があります。これを行う必要がある場合は、こちらをご覧ください。

デモプログラム

2つのデモプログラムのソースコードは、ダウンロードに含まれています。

1. メインデモプログラムは、3つのドロップファイルコンポーネントすべてとフィルターコンポーネントすべてを行使します。
2. フレームでtpjctrldropfilesを使用する方法を示すプログラム。

両方のデモプログラムには、最小限のDelphi 7が必要です。どちらも、Delphi 32ビットと64ビットWindowsコンパイラーと互換性があります。

デモの詳細については、 DemosディレクトリのファイルREADME.md参照してください。

履歴を更新します

ダウンロードに含まれるCHANGELOG.mdで完全な変更ログが提供されます。

ライセンスと免責事項

これらのコンポーネントは、Mozilla Public License v2.0の条件の下でリリースされます。

関連するすべての商標が認められています。

バグと機能リクエスト

バグは、プロジェクトの問題トラッカーを介して要求される新機能を報告または要求できます。 GitHubアカウントが必要です。

同様のレポートまたはリクエストのために問題がすでに作成されているかどうかを確認してください。もしそうなら、既存の問題にできるだけ多くの情報を含むコメントを追加してください、または追加するものがない場合は、追加するだけですか？ （ :+1:コメント。適切な既存の問題がない場合は、新しい問題を追加して、できるだけ多くの情報を提供してください。

著者について

私はピーター・ジョンソン - 英国ウェストウェールズのケレディジョンに住む愛好家プログラマーで、主にデルファイに執筆しています。私のプログラムとその他のライブラリコードは、https：//delphidabbler.com/から入手できます。

このドキュメントは著作権©2005-2022、PD Johnsonです。