This repository was archived by the owner on Aug 31, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 226
Expand file tree
/
Copy pathask-file.lcdoc
More file actions
113 lines (83 loc) · 3.91 KB
/
ask-file.lcdoc
File metadata and controls
113 lines (83 loc) · 3.91 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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
Name: ask file
Type: command
Syntax: ask file <prompt> [with <defaultFilePath>] [with filter <types>] [as sheet]
Summary:
Displays a standard Save <dialog box|dialog> for the user to enter a
<file> name and specify a location.
Introduced: 1.0
OS: mac, windows, linux
Platforms: desktop
Security: disk
Example:
ask file "Please name the file:"
Example:
ask file "Save data as" with "/HD/Data Stacks/filedata.rev" as sheet
Example:
ask file empty with "Untitled"
Example:
ask file "Export picture as:" with filter "JPEG file,*.jpg"
Parameters:
prompt (string):
If you specify empty, no prompt appears.
defaultFilePath:
The defaultFilePath consists of a folder path, or a suggested file name,
or both. The filename is the portion of the path after the last slash
character (/). If a folder path is provided in the defaultFilePath, the
dialog box shows the contents of that folder. Otherwise, it shows the
contents of the last folder you used with a file dialog box. If a
suggested file name is provided in the defaultFilePath, it appears in
the file name box.
types:
The types parameter specifies which extensions are available at the
bottom of the dialog box. A file type consists of an optional
description, a line feed or comma, and a file extension specification:
[description],*.extension
You can include more than one file type by separating the file types
with commas.
>*Cross-platform note:* The <types> <parameter> applies only to
> <Windows|Windows systems>. On <Mac OS> and <Unix|Unix systems>, this
> <parameter> has no effect.
It:
The absolute file path of the file the user chose is placed in the it
<variable>.
The result:
If the user cancels the <dialog box|dialog>, the <it> <variable> is set
to empty, and the <result> <function> <return|returns> cancel.
Description:
Use the <ask file> <command> to let the user provide the
<file path|name and location> of a new <file>.
The dialog box is the same one most applications use for the "Save"
command in the File menu. (If the systemFileSelector <property> is set
to true on <Mac OS> and <Windows|Windows systems>, and always on
<Unix|Unix systems>, the <application> displays its own built-in
<dialog box>, instead of the one provided by the operating system.)
>*Important:* The ask file command does not create the file. It only
> displays the dialog box and retrieves the path to the file the user
> specifies.
>*Note:* On Windows, it is imperative not to name a file with one of the
> reserved device names: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4,
> COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6,
> LPT7, LPT8 and LPT9. Also do not use these names followed by an
> extension, for example, NUL.tx7.
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.
If the systemFileSelector <property> is set to false, LiveCode's
built-in <dialog box> is used instead of the operating system's
<file dialog box|standard file dialog>.
>*Cross-platform note:* On <Mac OS|Mac OS systems> where Navigation
> Services is in use, if you don't specify a default file name, the file
> name box contains "untitled". On Unix and Windows systems, the file
> name box is empty when the <dialog box> appears. Unix systems
> currently use LiveCode's built-in dialog box.
Changes:
The ask file...as sheet form was introduced in version 2.0.
References: answer file (command), ask (command),
function (control structure), result (function), application (glossary),
return (glossary), variable (glossary), property (glossary),
file path (glossary), modal dialog box (glossary), dialog box (glossary),
command (glossary), Windows (glossary), file dialog box (glossary),
Mac OS (glossary), Unix (glossary), parameter (glossary), file (keyword),
it (keyword)
Tags: file system