FileItemPath

Returns a delimited list of file paths.

Syntax:

FileItemPath(file-list)

Parameters:

(s) file-list a string containing a list of filenames, which may be wildcarded. Limited to 260 characters. (example: "*.jpg|*.bmp")

Returns:

(s) a tab delimited list of full file-paths.

 

This function returns a tab delimited list of file-paths. This function is like FileItemize, but the list of file names it returns contains full path information.

This is especially useful in conjunction with the AskItemList function, which lets the user choose an item from such a delimited list.

Note: Some shell or file manager applications using the WIL Interpreter allow an empty string ("") to be used as the "file-list" parameter, in which case all files highlighted in the file display are returned. However, if there are any file names or wildcards in the string, all files matching the file names are returned, regardless of which ones are highlighted.

IntControl 91 controls the behavior of functions which take file masks, like FileItemPath. By default, masks only match the long version of the file name. For example, if you do FileItemize("*.htm"), it will not match a file "home.html" whose short name is "home~1.htm". If you want it to match the short version of the file name as well, set "p1" to 1.

By default hidden and system files are ignored. IntControl 5 can be used to control whether or not hidden files are processed by this function.

This function supports extended-length path names.

Examples:

a = FileItemPath("*.bak") ;all BAK files
b = FileItemPath("*.arc|*.zip|*.lzh") ;compressed files
; Get which .INI file to edit
DirChange("c:\windows")
ifiles = FileItemPath("*.ini")
ifile = AskItemlist(".INI Files", ifiles, @TAB, @UNSORTED, @SINGLE, @FALSE)
RunZoom("notepad", ifile)
See Also:

FileItemize, CurrentFile, DirItemize, AskItemList, IntControl 5, IntControl 91