Difference between revisions of "love.filedropped"

m (It is DroppedFile)
m
(3 intermediate revisions by one other user not shown)
Line 10: Line 10:
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
== Examples ==
 +
Read and print the file, drag-and-dropped to love window using [[(File):read]] and [[(File):getFilename]].
 +
<source lang="lua">
 +
function love.filedropped(file)
 +
    local data = file:read()
 +
    print("Content of " .. file:getFilename() .. ' is')
 +
    print(data)
 +
    print("End of file")
 +
end
 +
</source>
 +
 
== Notes ==
 
== Notes ==
 
[[(File):open|File:open]] must be called on the file before reading from or writing to it. [[(File):getFilename|File:getFilename]] will return the full platform-dependent path to the file.
 
[[(File):open|File:open]] must be called on the file before reading from or writing to it. [[(File):getFilename|File:getFilename]] will return the full platform-dependent path to the file.
Line 17: Line 28:
 
[[Category:Callbacks]]
 
[[Category:Callbacks]]
 
{{#set:Description=Callback function triggered when a file is dragged and dropped onto the window.}}
 
{{#set:Description=Callback function triggered when a file is dragged and dropped onto the window.}}
{{#set:Subcategory=General}}
+
{{#set:Subcategory=Window}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.filedropped}}
 
{{i18n|love.filedropped}}

Revision as of 22:31, 7 March 2019

Available since LÖVE 0.10.0
This function is not supported in earlier versions.

Callback function triggered when a file is dragged and dropped onto the window.

Function

Synopsis

love.filedropped( file )

Arguments

DroppedFile file
The unopened File object representing the file that was dropped.

Returns

Nothing.

Examples

Read and print the file, drag-and-dropped to love window using (File):read and (File):getFilename.

function love.filedropped(file)
    local data = file:read()
    print("Content of " .. file:getFilename() .. ' is')
    print(data)
    print("End of file")
end

Notes

File:open must be called on the file before reading from or writing to it. File:getFilename will return the full platform-dependent path to the file.

See Also


Other Languages