folder.copyTo( )

4D v19.8

folder.copyTo( )


folder.copyTo ( carpetaDestino {; nuevoNombre}{; sobreescribir} ) -> Resultado

Parámetro	Tipo	Descripción
carpetaDestino	Objeto	Carpeta destino
nuevoNombre	Texto	Nombre de la copia
sobreescribir	Entero largo	Sobrescribir fk para reemplazar elementos existentes
Resultado	Objeto	Carpeta copiada

Descripción

El método folder.copyTo( ) copia el objeto Folder (carpeta fuente) en la carpetaDestino especificada .

La carpetaDestino debe existir en el disco, de lo contrario se genera un error.

De forma predeterminada, la carpeta se copia con el nombre de la carpeta original. Si desea cambiar el nombre de la copia, pase el nuevo nombre en el parámetro nuevoNombre. El nuevo nombre debe cumplir con las reglas de denominación (por ejemplo, no debe contener caracteres como ":", "/", etc.), de lo contrario se devuelve un error.

Si ya existe una carpeta con el mismo nombre en la carpetaDestino y no está vacía, de forma predeterminada, 4D comprueba su contenido antes de copiar los elementos y genera un error si existe un archivo con el mismo nombre. Puede pasar la constante fk overwrite en el parámetro sobrescribir para ignorar y sobrescribir la carpeta existente:

Constante	Valor	Comentario
fk overwrite	4	Sobrescribir los elementos existentes, si los hay

Objeto devuelto

El método devuelve el objeto Folder copiado.

Ejemplo

Desea copiar una carpeta Imágenes de la carpeta de documentos del usuario a la carpeta de la base:

 C_OBJECT($userImages;$copiedImages)

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

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

Ver también

COPY DOCUMENT
folder.moveTo( )