folder.moveTo( )

4D v19.8

folder.moveTo( )


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

Parâmetro	Tipo	Descrição
pastaDestino	Objeto	Pasta de Destino
novoNome	Texto	Nome da pasta movida
Resultado	Objeto	Pasta movida

Descrição

O método folder.moveTo( ) move ou renomeia 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 conserva seu nome quando se mover. Se quiser mudar o nome da pasta movida, 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.

Objeto devolvido

O método devolve o objeto Folder movido.

Exemplo

Se quiser mover e renomear uma pasta:

 C_OBJECT($tomove;$moved)

 $docs:=Folder(fk documents folder)

 $tomove:=$docs.folder("Pictures")

 $tomove2:=$tomove.moveTo($docs.folder("Archives");"Pic_Archives")

Ver também

file.moveTo( )
folder.copyTo( )