onClientResourceFileDownload

Disparado a cada mudança de estado de um arquivo sendo baixado para um resource.

Origem

O elemento raiz do resource ao qual o arquivo pertence. Cai para root quando esse resource ainda não tem elemento.

Parâmetros

Posição	Nome	Tipo	Descrição
1	oResource	resource	Resource ao qual o arquivo pertence.
2	nomeDoArquivo	string	Caminho do arquivo dentro do resource.
3	tamanho	number	Tamanho do arquivo, em bytes.
4	estado	string	"queued", "finished" ou "failed".

Cancelável

Não.

Os três estados são a vida inteira de um arquivo: queued quando o download está prestes a começar, depois finished ou failed. Um arquivo que falha é tentado algumas vezes antes de o estado failed ser avisado, então ele não dispara uma vez por tentativa.

Nota

Um arquivo que já está no cache local não gera evento nenhum — ele não é baixado. Ou seja, os totais que você acumula a partir do queued cobrem só o que realmente passa pela rede, que é exatamente o que uma barra de progresso deve mostrar.

Exemplo

addEventHandler("onClientResourceFileDownload", root,
function(oResource, nomeDoArquivo, tamanho, estado)
    if estado == "failed" then
        outputDebugString("não deu para baixar " .. getResourceName(oResource) .. "/" .. nomeDoArquivo)
    end
end)

Veja também

• onClientFileDownloadComplete — Disparado quando um arquivo termina de baixar, tendo dado certo ou não.
• onClientTransferBoxVisibilityChange — Disparado quando a caixa de transferência aparece ou some.
• onClientTransferBoxProgressChange — Disparado conforme o download avança.