Adobe 12040118 Using Help - Page 68

Help Using Help Reference Back 68 Parameters prompt select select (Win) select (Mac OS) An optional prompt (expressed as a string) that is displayed as part of the dialog if the dialog permits the display of an additional message. This argument allows the pre-selection of the files that the dialog displays. Unfortunately, this argument is different on Mac OS and on Windows. Windows selection string is actually a list of file types with explanative text. This list appears in the bottom of the dialog box as a drop-down list box so the user can select which types of files to display.The elements of this list are separated by commas. Each element starts with the descriptive text, followed by a colon and the file search masks for this text. Again, each search mask is separated by a semicolon. A Selection list that allowed the selection of all text files (*.TXT and *.DOC) or all files would look like this: Text Files:*.TXT;*.DOC,All files:* A single asterisk character is a placeholder for all files. On Mac OS, the optional second argument is a callback function. This function takes one argument, which is a File object. When the dialog is set up, it calls this callback function for each file that is about to be displayed. If the function returns anything else than true, the file is not displayed. This is true only for the openDialog() method; the saveDialog() method ignores this callback method. Returns File object, or null if the user cancels the dialog. See also "FileSource object" on page 71. File read() method File(path).read(chars) Description The File read() method reads the contents of the file from the current position on. Returns a string that contains up to the number of characters that were supposed to be read. Parameters chars The number of characters to read, expressed as an integer. If the number of characters to read is not supplied, the entire file is read in one big chunk, starting at the current position. If the file is encoded, multiple bytes may be read to create single Unicode characters. Returns String. File readch() method File(path).readch() Description The File readch() method reads one single text character. Line feeds are recognized as CR, LF, CRLF or LFCR pairs. If the file is encoded, multiple bytes may be read to create single Unicode characters. Parameters None. Using Help Back 68