dropfiles

Soltar componentes de arquivos

Conteúdo

• Descrição
• Instalação
• Programas de demonstração
• Atualizar histórico
• Licença e isenção de responsabilidade
• Bugs e solicitações de recursos
• Sobre o autor

Descrição

Três componentes são fornecidos que suportam arrastar e soltar do Windows Explorer, juntamente com componentes subsidiários que podem filtrar arquivos soltos. Os componentes são:

• TPJDROPFILES - Controle de contêiner que captura arquivos arrastados e soltos na área do cliente ou na área do cliente de controles filhos.
• TPFormDropFiles - Componente não visual que captura os arquivos arrastados e soltados do Explorer para o formulário que contém o componente.
• TPJCTRLDROPFILES - Componente não visual que captura arquivos arrastados e caiu do Explorer para um controle associado.
• TPJEXTFILEFILTER - Componente de filtro de arquivo que filtra arquivos de acordo com sua extensão.
• TPJWildCardFileFilter - Componente de filtro de arquivo que filtra arquivos de acordo com um curinga no estilo DOS.
• TPJFILEFILTER - Uma classe base abstrata para componentes do filtro de arquivos.

Alguma assistência no tempo de design é fornecida pelos editores de componentes e propriedades.

Os principais recursos dos componentes dos arquivos suspensos são:

• Um evento ONDROPFILES é acionado quando os arquivos são descartados.
• Os nomes dos arquivos descartados são disponibilizados através da propriedade Array Array. Por conveniência, o nome do primeiro arquivo também é armazenado na propriedade FileName .
• A lista de arquivos descartados pode ser configurada para incluir apenas arquivos, apenas pastas ou todos os arquivos e pastas.
• As pastas descartadas podem ser cortadas para que todos os arquivos e subpastas em cada uma das pastas descartadas sejam listadas.
• Os filtros podem ser aplicados aos arquivos e pastas descartadas. Isso é feito de duas maneiras:
  • Lidando com o evento OnFileFilter e decidindo quais arquivos e pastas passarem pelo filtro.
  • Ao vincular o componente de arquivo suspenso a um componente de filtro de arquivo especial, derivado do tpjfilefilter abstrato. Nesse caso, os arquivos abandonados são filtrados automaticamente pelo componente do filtro. São fornecidos dois componentes de filtro: TPJEXTFILEFILTER que filtra de acordo com as extensões de arquivo e o TPJWildCardFileFilter que filtra usando placas curinga no estilo DOS. Os desenvolvedores podem criar outros componentes de filtro, derivando do TPJFileFilter .
• O mouse coordena onde os arquivos foram retirados podem ser recuperados, assim como uma referência a qualquer controle sob o cursor do mouse na época.
• O evento OnBeForedrop pode ser usado para fazer o pré-processamento antes que os arquivos sejam realmente descartados.
• A propriedade ISFolder Array informa se um item equivalente na propriedade Files for um arquivo ou uma pasta.
• A janela própria pode ser trazida para a frente quando os arquivos são descartados.

Compatibilidade

Os componentes foram testados nos compiladores Delphi 7 a XE4 Windows (exceto Delphi 2005) e os compiladores Delphi Xe2 a XE4 de 64 bits. Pensa -se que os componentes compilam os compiladores de volta ao Delphi 3, mas isso não é garantido.

Os componentes são usados apenas com o VCL: eles não são compatíveis com o Firemonkey.

As plataformas .NET e não-Windows não são suportadas.

Instalação

Os componentes de arquivos suspensos , sua documentação e os programas de demonstração são fornecidos em um arquivo zip. Antes de instalar, você precisa extrair todos os arquivos do arquivo zip, preservando a estrutura do diretório. Os seguintes arquivos serão extraídos:

• PJDropFiles.pas - código -fonte do componente.
• PJDropFiles.dcr - Glyphs da paleta de componentes.
• PJDropFilesDsgn.pas - Editores de propriedades e código -fonte de registro de componentes.
• PJDropFilesDsgn.dfm - Formulário do editor de propriedades.
• README.md - este arquivo.
• CHANGELOG.md - Log de alterações do componente.
• MPL-2.txt -A licença pública de Mozilla v2.0.
• Documentation.URL -Curto-cut para a documentação on-line do componente.

Além dos arquivos acima, você encontrará o código-fonte de dois projetos de demonstração da Demo1 e Demo2 subdiretórios.

Agora você pode instalar os componentes no Delphi IDE. Para fazer isso, os arquivos PJDropFiles.pas , PJDropFiles.dcr , PJDropFilesDsgn.pas e PJDropFilesDsgn.dfm devem ser adicionados a um pacote de tempo de design. Se você precisar de ajuda para fazer isso, veja aqui.

Programas de demonstração

O código -fonte para dois programas de demonstração está incluído no download:

1. O programa de demonstração principal exerce todos os três componentes de arquivos suspensos e os componentes do filtro.
2. Um programa que demonstra como usar o TPJCTRLDROPFILES com quadros.

Ambos os programas de demonstração exigem o Delphi 7 no mínimo. Ambos são compatíveis com os compiladores Delphi 32 Bits e 64 Bit Windows.

Para obter mais informações sobre as demos, consulte o arquivo README.md no diretório Demos .

Atualizar histórico

Um log de alterações completo é fornecido no CHANGELOG.md incluído no download.

Licença e isenção de responsabilidade

Esses componentes são divulgados sob os termos da licença pública de Mozilla v2.0.

Todas as marcas comerciais relevantes são reconhecidas.

Bugs e solicitações de recursos

Os bugs podem ser relatados ou novos recursos solicitados através do rastreador de problemas do projeto. Uma conta do GitHub é necessária.

Verifique se um problema já foi criado para um relatório ou solicitação semelhante. Nesse caso, adicione um comentário que contenha o máximo de informações possível ao problema existente, ou se você não tiver nada a acrescentar, basta adicionar um? ( :+1: Comente. Se não houver um problema existente adequado, adicione um novo problema e forneça o máximo de informações possível.

Sobre o autor

Sou Peter Johnson - um programador hobby que vive em Ceredigion em West Wales, Reino Unido, escrevendo principalmente em Delphi. Meus programas e outros código da biblioteca estão disponíveis em: https://delphidabbler.com/.

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