Arquivos e pastas

CAPCAD_FILE_TOOLS — listar os arquivos de uma pasta

Abre um formulário pequeno e não modal com um caminho, uma extensão e um botão. Clicar no botão lista os arquivos daquela pasta numa janela de texto.

Sem captura de tela nesta página. O FileToolsForm só existe com o CAD aberto. A tabela abaixo descreve os controles pelo rótulo que eles mostram.

A varredura é só do primeiro nível: subpastas não são visitadas.

A janela de resultado

O resultado abre numa janela modal chamada Files, com o texto em fonte monoespaçada, somente leitura e com barras de rolagem nos dois sentidos. Ela traz três botões:

Um caminho que deixe de existir entre o preenchimento e o clique, ou uma extensão inválida, param com a mensagem de erro do sistema numa caixa do CapCad — a lista simplesmente não abre.

CAPCAD_PICK_FILES e CAPCAD_PICK_FOLDER — as caixas do Windows

São comandos-ponte. Eles não fazem nada com o desenho: abrem a caixa de diálogo do Windows e gravam a escolha na variável de sistema USERS3, para que outro programa — um script, uma rotina AutoLISP, um comando do próprio CapCad — leia o resultado dali.

Hoje são o caminho oficial para pedir um arquivo ou uma pasta ao usuário a partir de uma automação.

Como se chama

Cada comando pede uma linha de argumentos separados por barra vertical (|). A linha é lida com espaços permitidos, então tudo entra num único parâmetro depois do nome do comando.

CAPCAD_PICK_FILES     Label|Extension|InitialDir|AllowMultiple:
                      padrão ao apertar Enter →  Select files|*||1

CAPCAD_PICK_FOLDER    Label|InitialDir:
                      padrão ao apertar Enter →  Select folder|

De uma rotina AutoLISP:

(command "CAPCAD_PICK_FILES" "Escolha os desenhos|dwg|C:/Projetos/Trecho1|1")
(setq escolhidos (getvar "USERS3"))   ; "C:\\...\\a.dwg|C:\\...\\b.dwg" ou "" se cancelado

CAPCAD_PICK_FILES, campo a campo

O resultado é o caminho completo de cada arquivo, separados por |. Cancelar grava texto vazio em USERS3.

CAPCAD_PICK_FOLDER, campo a campo

A caixa traz o botão de criar nova pasta. O resultado é o caminho da pasta com barra invertida no fim (C:\Projetos\Trecho1\). Cancelar grava texto vazio.

O que fica guardado entre sessões

Nada. O FileToolsForm abre sempre com o caminho vazio e a extensão dwg, e os dois comandos de escolha não gravam preferência nenhuma — só a variável USERS3, que é do desenho corrente e não sobrevive ao fechamento do CAD.

Notas

• Extensões de três letras pegam mais do que você pediu. O filtro *.dwg é resolvido pelo Windows, que para extensões de exatamente três caracteres também devolve arquivos cuja extensão começa com o texto — um plano.dwg1 aparece numa listagem de dwg. Use * e leia a lista quando isso importar.
• A listagem não entra em subpastas. Para varrer uma árvore inteira, liste pasta por pasta.
• USERS3 é uma variável do CAD, não do CapCad. Qualquer outro comando ou rotina pode sobrescrevê-la. Leia-a imediatamente depois de chamar o comando de escolha.
• USERS3 guarda texto e tem tamanho limitado. Uma seleção com dezenas de caminhos longos pode não caber inteira; nesse caso escolha por pasta em vez de por arquivo.
• Cancelar e "não escolher nada" são a mesma coisa. Os dois comandos gravam texto vazio quando você cancela — inclusive quando cancela o prompt de argumentos, antes de a caixa abrir. Teste sempre o resultado antes de usá-lo.
• Parte da interface está em inglês no produto em português: o título da janela de resultado (Files), os textos padrão Select files e Select folder, e o rótulo do filtro All files.
• Nos outros CADs. No ARES Commander o CAPCAD_FILE_TOOLS não está disponível nesta versão, e avisa; CAPCAD_PICK_FILES e CAPCAD_PICK_FOLDER só estão disponíveis no AutoCAD.