Remove um arquivo em um diretório no dispositivo móvel.

Open

Compatibilidade

• Bloco cliente mobile: cronapi.cordova.file.removeFile()

Retorno

Quando o arquivo é removido com sucesso, o bloco retorna uma string, contendo o texto "OK", indicando que o arquivo foi removido.

Parâmetros

Nome do Arquivo

Caminho completo do arquivo a ser removido. Neste parâmetro deve ser inserido o bloco Obter Diretório, que especifica o diretório que deverá ser criado o arquivo, juntamente com um bloco de texto, que deve conter o nome do arquivo e sua extensão. Para concatenar essas informações utilize o bloco criar texto com, assim como exibido no Exemplo.

• Posição: 1

• Inglês: File Name

• Tipo: Texto / String

Sucesso

Executa uma ação caso o arquivo seja removido com sucesso.

• Posição: 2

• Inglês: Success

• Tipo: Comando com retorno ("item") / Command with return ("item")

• Exemplo: uso do bloco Exibir Notificação

Erro

Executa uma ação caso ocorra um erro durante a remoção do arquivo.

• Posição: 3

• Inglês: Error

• Tipo: Comando com retorno ("item") / Command with return ("item")

• Exemplo: uso do bloco Exibir Notificação

Exemplo

A função abaixo mostra um exemplo de uso do bloco Remover Arquivo. No parâmetro Nome do Arquivo, inserimos o bloco de concatenação criar texto com, e nele adicionamos o bloco Obter Diretório, indicando que o arquivo deverá ser criado no diretório interno do dispositivo móvel, e um bloco de texto com o nome do arquivo que será removido. 

O bloco Exibir Notificação retornará uma mensagem a depender do resultado da remoção do arquivo. Caso ocorra com sucesso, o fluxo de execução é direcionado para os comandos contidos no parâmetro Sucesso, caso contrário, os comandos em Erro são executados.

Open

A imagem a seguir mostra o resultado de execução da função da Figura 2. Após clicar no botão "Remover arquivo", a função será executada e o arquivo será removido do dispositivo. Na imagem, vemos a notificação exibida após esta ação.

Open

Nesta página