mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-22 06:45:09 +00:00
29 lines
1.3 KiB
Text
29 lines
1.3 KiB
Text
{{DISPLAYTITLE:_TOTALDROPPEDFILES}}
|
|
The [[_TOTALDROPPEDFILES]] function returns the number of items (files or folders) dropped in a program's window after [[_ACCEPTFILEDROP]] is enabled.
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|totalFilesReceived&}} = [[_TOTALDROPPEDFILES]]
|
|
|
|
|
|
{{PageDescription}}
|
|
* After [[_ACCEPTFILEDROP]] is enabled, [[_TOTALDROPPEDFILES]] will return 0 until the user drops files or folders into the program's window.
|
|
* When using [[_DROPPEDFILE]] to read the list sequentially, [[_TOTALDROPPEDFILES]] will be reset to 0 after the last item is retrieved (after [[_DROPPEDFILE]] returns an empty string "").
|
|
* If using [[_DROPPEDFILE]] with an index, you must call [[_FINISHDROP]] after you finish working with the list.
|
|
* When using [[_DROPPEDFILE]] to read the list with an index, [[_TOTALDROPPEDFILES]] will '''not''' be reset (and the list of items won't be cleared) until [[_FINISHDROP]] is called.
|
|
* '''[[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Keyword Not Supported in Linux or MAC versions]]'''.
|
|
|
|
|
|
==Availability==
|
|
* '''Version 1.3 and up'''.
|
|
|
|
|
|
{{PageExamples}}
|
|
* See example for [[_ACCEPTFILEDROP]]
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_ACCEPTFILEDROP]], [[_DROPPEDFILE]], [[_FINISHDROP]]
|
|
* [[_FILEEXISTS]], [[_DIREXISTS]]
|
|
|
|
|
|
{{PageNavigation}}
|