dropfiles

COMPONENTES DE LOS FILES

Contenido

• Descripción
• Instalación
• Programas de demostración
• Historial de actualizaciones
• Licencia y descargo de responsabilidad
• Errores y solicitudes de funciones
• Sobre el autor

Descripción

Se suministran tres componentes que admiten arrastrar y soltar desde Windows Explorer junto con componentes subsidiarios que pueden filtrar archivos abandonados. Los componentes son:

• TPJDROPFILES - Control de contenedores que atrapa archivos arrastrados y caídos en su área de cliente o en el área del cliente de los controles infantiles.
• TPFORMDROPFILES : componente no visual que atrapa archivos arrastrados y eliminados del Explorer en el formulario que contiene el componente.
• TPJCTRLDROPFILES : componente no visual que atrapa archivos arrastrados y caídos del Explorador a un control asociado.
• TPJextFileFilter : componente de filtro de archivo que filtra los archivos según su extensión.
• TpjwildcardfileFilter : componente de filtro de archivo que filtra archivos según un comodín de estilo DOS.
• TPJFileFilter : una clase base abstracta para componentes del filtro de archivo.

El componente y los editores de propiedades y los editores de propiedades proporcionan cierta asistencia de diseño.

Las características clave de los componentes de los archivos de caída son:

• Se activa un evento OnDropFiles cuando se eliminan los archivos.
• Los nombres de los archivos desconcertados están disponibles a través de la propiedad de la matriz de archivos . Por conveniencia, el nombre del primer archivo también se almacena en la propiedad del nombre de archivo .
• La lista de archivos abandonados se puede configurar para incluir solo archivos, solo carpetas o todos los archivos y carpetas.
• Las carpetas caídas se pueden reportar para que se enumeren todos los archivos y subcarpetas en cada una de las carpetas caídas.
• Los filtros se pueden aplicar a los archivos y carpetas abandonados. Esto se hace de una de dos maneras:
  • Al manejar el evento OnFileFilter y decidir qué archivos y carpetas pasar a través del filtro.
  • Vinculando el componente del archivo de sueldo a un componente de filtro de archivo especial, derivado del abstracto TPJFileFilter . En este caso, el componente del filtro filtran automáticamente los archivos eliminados. Se proporcionan dos componentes del filtro: tpnextFileFilter que se filtra de acuerdo con las extensiones de archivos y tpjwildcardfileFilter que filtra con tarjetas salvajes de estilo DOS. Los desarrolladores pueden crear componentes de filtro adicionales derivando de TPJFileFilter .
• Se pueden recuperar las coordenadas del mouse donde se eliminaron los archivos, al igual que una referencia a cualquier control debajo del cursor del mouse en ese momento.
• El evento OnbeforDrop se puede usar para hacer un preprocesamiento antes de que los archivos realmente se eliminen.
• La propiedad de la matriz ISFolder informa si un elemento equivalente en la propiedad de archivos es un archivo o una carpeta.
• La ventana de propiedad se puede llevar al frente cuando se eliminan los archivos.

Compatibilidad

Los componentes se han probado en los compiladores de Windows Delphi 7 a XE4 (excepto Delphi 2005) y los compiladores de 64 bits Delphi XE2 a XE4 de 64 bits. Se cree que los componentes compilan en los compiladores de regreso a Delphi 3, pero eso no está garantizado.

Los componentes son para usar solo con el VCL: no son compatibles con Firemonkey.

Las plataformas .NET y no Windows no son compatibles.

Instalación

Los componentes de los archivos , su documentación y los programas de demostración se suministran en un archivo zip. Antes de instalar, debe extraer todos los archivos del archivo zip, preservando la estructura del directorio. Se extraerán los siguientes archivos:

• PJDropFiles.pas - Código fuente del componente.
• PJDropFiles.dcr - Glifos de paleta de componentes.
• PJDropFilesDsgn.pas - Código fuente de registro de editores de propiedades y componentes.
• PJDropFilesDsgn.dfm - Formulario de editor de propiedades.
• README.md - Este archivo.
• CHANGELOG.md - Registro de cambio de componente.
• MPL-2.txt -La licencia pública de Mozilla v2.0.
• Documentation.URL -atajado en la documentación en línea del componente.

Además de los archivos anteriores, encontrará el código fuente de dos proyectos de demostración de los subdirectorios Demo1 y Demo2 .

Ahora puede instalar los componentes en el IDE Delphi. Para hacer esto, los archivos PJDropFiles.pas , PJDropFiles.dcr , PJDropFilesDsgn.pas y PJDropFilesDsgn.dfm deben agregarse a un paquete de tiempo de diseño. Si necesita ayuda para hacer esto, consulte aquí.

Programas de demostración

El código fuente para dos programas de demostración se incluye en la descarga:

1. El programa principal del programa de demostración ejerce los tres componentes de archivos de caída y los componentes del filtro.
2. Un programa que demuestra cómo usar tpjctrldropfiles con marcos.

Ambos programas de demostración requieren Delphi 7 como mínimo. Ambos son compatibles con los compiladores de Windows de 32 bits y 64 bits Delphi.

Para obtener más información sobre las demostraciones, consulte el archivo README.md en el directorio Demos .

Historial de actualizaciones

Se proporciona un registro de cambio completo en CHANGELOG.md que se incluye en la descarga.

Licencia y descargo de responsabilidad

Estos componentes se lanzan bajo los términos de la Licencia Pública de Mozilla v2.0.

Se reconocen todas las marcas comerciales relevantes.

Errores y solicitudes de funciones

Se pueden informar errores o se solicitan nuevas funciones a través del rastreador de problemas del proyecto. Se requiere una cuenta de GitHub.

Compruebe si ya se ha creado un problema para un informe o solicitud similar. Si es así, agregue un comentario que contenga la mayor cantidad de información que pueda al problema existente, o si no tiene nada que agregar, ¿simplemente agregue un? ( :+1: Comentario. Si no hay un problema existente adecuado, agregue un nuevo problema y proporcione la mayor cantidad de información posible.

Sobre el autor

Soy Peter Johnson, un programador aficionado que vive en Ceredigion en West Gales, Reino Unido, escribiendo principalmente en Delphi. Mis programas y otro código de biblioteca están disponibles en: https://delphidabbler.com/.

Este documento es Copyright © 2005-2022, PD Johnson.