forked from livecode/livecode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathanswer-file.lcdoc
More file actions
93 lines (69 loc) · 2.9 KB
/
answer-file.lcdoc
File metadata and controls
93 lines (69 loc) · 2.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
Name: answer file
Type: command
Syntax: answer file[s] <prompt> [with <defaultPath>] [titled <windowTitle>] [as sheet]
Summary:
Displays a <file dialog box|standard file dialog> for the user to select
a file.
Introduced: 1.0
OS: mac, windows, linux
Platforms: desktop
Security: disk
Example:
answer file "Select a file to delete:"
if the result is not "Cancel" then
put it into tChosenFile
-- Use the file path as required
end if
Example:
answer files "Select the files you wish to process:"
if the result is not "Cancel" then
put it into tChosenFiles
repeat for each line tFile in tChosenFiles
end repeat
end if
Example:
answer file "Input:" with "/Macintosh HD/"
Parameters:
prompt (string):
If you specify empty, no prompt appears.
defaultPath:
The name and location of the folder whose contents are
listed when the dialog box appears. If no <defaultPath> is specified,
the dialog box lists the contents of the last folder you used with a
file dialog box.
windowTitle:
If specified, appears in the title bar of the dialog box.
If no <windowTitle> is given, the title bar is blank. This parameter
has no effect on macOS 10.11 (El Capitan) and above, so make sure that any important information is placed in the <prompt> parameter.
It:
The <answer file> command places the absolute file path(s) of the
selected file(s) as a return delimited list in the it variable.
The result:
If the user cancels the dialog, the it variable is set to
empty, and the result function returns "Cancel".
Description:
Use the answer file command to open a file chooser dialog.
The dialog box displayed is the same one most programs use for the
"Open" command in the File menu.
>*Important:* The answer file command does not open the file. It only
> displays the dialog box and retrieves the path to the file the user
> specifies.
If the as sheet form is used, the dialog box appears as a sheet on OS X
systems. On other systems, the as sheet form has no effect and the
dialog box appears normally. Attempting to open a sheet from within
another sheet displays the second stack as a modal dialog box instead.
To give a dialog box a prompt when using the as sheet form a non-empty
title must be provided. This will cause the prompt to appear in the
same place it would if as sheet was not being used.
If the <systemFileSelector> property is set to false, LiveCode's
built-in dialog box is used instead of the operating system's
standard file dialog.
>*Note:* If you wish to filter the list of the files presented to
> the user, use the <answer file with type> command.
References: ask file with type (command), revCopyFile (command),
open file (command), answer (command), ask file (command),
answer file with type (command), answer folder (command),
revUnixFromMacPath (function), files (function),
revMacFromUnixPath (function), file dialog box (glossary), it (keyword),
systemFileSelector (property), dontUseNS (property)
Tags: file system