folder.copyTo( )

4D v19.8

folder.copyTo( )


folder.copyTo ( pastaDestino {; novoNome}{; sobrescrever} ) -> Resultado

Parâmetro	Tipo	Descrição
pastaDestino	Objeto	Pasta de destino
novoNome	Texto	Nome da cópia
sobrescrever	Inteiro longo	fk overwrite para substituir elementos existentes
Resultado	Objeto	Pasta copiada

Descrição

O método folder.copyTo( ) copia o objeto Folder (pasta fonte) na pastaDestino especificada .

A pastaDestino deve existir no disco, do contrário se gera um erro.

De forma predeterminada, a pasta se copia com o nome da pasta original. Se quiser mudar o nome da cópia, passe o novo nome no parâmetro novoNome. O novo nome deve cumprir com as regras de denominação (por exemplo, não deve conter caracteres como ":", "/", etc.), do contrário se devolve um erro.

Se já existir uma pasta com o mesmo nome na pastaDestino e não estiver vazia, de forma predeterminada, 4D comprova seu conteúdo antes de copiar os elementos e gera um erro se existir um arquivo com o mesmo nome. Pode passar a constante fk overwrite no parâmetro sobrescrever para ignorar e sobrescrever a pasta existente:

Constante	Valor	Comentário
fk overwrite	4	Sobrescrever os elementos existentes, se houver

Objeto devolvido

O método devolve o objeto Folder copiado.

Exemplo

Se quiser copiar uma pasta Imagens da pasta de documentos de usuário à pasta do banco de dados:

 C_OBJECT($userImages;$copiedImages)

 $userImages:=Folder(fk documents folder+"/Pictures/")

 $copiedImages:=$userImages.copyTo(Folder(fk database folder);fk overwrite)

Ver também

COPY DOCUMENT
folder.moveTo( )