OnClientResourceFileDownload: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Remove obsolete Requirements section)
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client event}}  
{{Client event}}  
{{Added feature/item|3.0160|1.5.9|1.5.8|20788|This event is triggered every time a [[resource]] file download is queued, finished or has failed.}}
{{Added feature/item|1.5.9|1.5.8|20788|This event is triggered every time a [[resource]] file download is queued, finished or has failed.}}
{{Warning|This event is '''NOT''' related to [[downloadFile]] and [[onClientFileDownloadComplete]]!|true}}
{{Warning|This event is '''NOT''' related to [[downloadFile]] and [[onClientFileDownloadComplete]]!|true}}


==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
resource fileResource, string fileName, number fileSize, string state
resource fileResource, string fileName, int fileSize, string state
</syntaxhighlight>
</syntaxhighlight>
*'''fileResource:''' [[Resource]] the file belongs to.
*'''fileResource:''' [[Resource]] the file belongs to.
Line 19: Line 19:
This example will output the file's resource name/file name/size/state when downloading:
This example will output the file's resource name/file name/size/state when downloading:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function writeMsg (resourceName, fileName, fileSize, fileState)
function writeMsg (fileResource, fileName, fileSize, state)
     outputChatBox ("Resource name: "..resourceName..", file name: "..fileName..", size: "..fileSize..", state: "..fileState)
    local resourceName = getResourceName( fileResource )
     outputChatBox ( "Resource name: " .. resourceName .. ", file name: " .. fileName .. ", size: " .. fileSize .. ", state: " .. state)
end
end


addEventHandler ("onClientResourceFileDownload", root, writeMsg)
addEventHandler ("onClientResourceFileDownload", root, writeMsg)
</syntaxhighlight>
</syntaxhighlight>
==Requirements==
{{Requirements|n/a|1.5.8-9.20788|}}


==See Also==
==See Also==

Latest revision as of 17:26, 7 November 2024

This event is triggered every time a resource file download is queued, finished or has failed.

Dialog-warning.png Warning: This event is NOT related to downloadFile and onClientFileDownloadComplete!

Parameters

resource fileResource, string fileName, int fileSize, string state
  • fileResource: Resource the file belongs to.
  • fileName: Relative resource file path.
  • fileSize: Size of the file in bytes.
  • state: Possible values: "queued" or "finished" or "failed".

Source

The source of this event is the resource's root element.

Example

This example will output the file's resource name/file name/size/state when downloading:

function writeMsg (fileResource, fileName, fileSize, state)
    local resourceName = getResourceName( fileResource )
    outputChatBox ( "Resource name: " .. resourceName .. ", file name: " .. fileName .. ", size: " .. fileSize .. ", state: " .. state)
end

addEventHandler ("onClientResourceFileDownload", root, writeMsg)

See Also

Client resource events


Client event functions