go | |||||||||||||||||||
Type | command | ||||||||||||||||||
Dictionary | LCS | ||||||||||||||||||
Library | LiveCode Script | ||||||||||||||||||
Syntax |
| ||||||||||||||||||
Synonyms | open | ||||||||||||||||||
Summary | |||||||||||||||||||
Introduced | 1.0 | ||||||||||||||||||
OS | mac, windows, linux, ios, android | ||||||||||||||||||
Platforms | desktop, mobile | ||||||||||||||||||
Parameters |
| ||||||||||||||||||
Example |
| ||||||||||||||||||
Values |
| ||||||||||||||||||
Related | Keyword: previous, recent, as, card Property: lockRecent, lockScreen, HCImportStat, visible, defaultStack, defaultFolder Command: unlock recent, show, show cards, drawer, modeless, push Object: stack Glossary: command, property | ||||||||||||||||||
Description | Use the go command to move to another card in the current stack, to open a stack and go to a card within it, or to move backward and forward among recently visited cards. If the stack is open, is closed but loaded into memory, or is listed in the current stack's stackFiles property, you can specify it simply by name: go stack "My Stack" Otherwise, you must include the stack's file path. If the specified file path is relative, the go command will look in the defaultFolder. When going to a previously-unopened stack, if you don't specify a card, the go command displays the first card of the stack. If the stack is already open, the current card of the stack appears and the stack window is brought to the front. If the lockScreen property is set to true, the go command does not bring an already-open stack to the front until the lockScreen is set to false. (Remember that the lockScreen is automatically set to false when all pending handlers finish executing.) If you specify a mode, the stack opens in the specified mode. If you don't specify a mode, the stack opens in whatever mode is specified by the stack's style property. When going to a stack, you can specify a mode or a window for the stack to appear in, but not both.
The go... as sheet form can be used only on OS X systems. If you use this form on Mac OS, Unix, or Windows, the stack is displayed as a modal dialog box instead. If you don't specify a mode, the stack is opened with the mode specified by its style property. If you specify a URL, the stack is downloaded from that URL and displayed. The stack must be in stack file format (that is, not compressed or archived). Stacks opened in this way are treated as unsaved stacks; the long name of such a stack is the same as its abbreviated name, until the stack is saved on a local disk. The downloaded stack is a copy: changes you make to the stack are not automatically made on the server the stack came from. To change the stack on the server, you must save the stack file locally and re-upload it. You can go to the first, previous, next, or last card of the current stack. The form go any card goes to a random card in the current stack. If you include the marked parameter, the go command is restricted to cards whose mark property is set to true. Each card the user visits while the lockRecent property is false is placed in the recent cards list. You can use the go command to move among the previously-visited cards:
If you use the go visible form, the stack is made visible after being opened. (When going to a stack, this form sets the stack's visible property to true.) Use this form of the go command to display a script-only stack without explicitly setting the visible (property) in the openStack or preOpenStack handlers. If you use the go invisible form, the window or card change does not show on the screen. (When going to a stack, this form sets the stack's visible property to false.) Use this form of the go command to open a stack without displaying it on screen. To display the stack later, use the show command or set its visible (property)to true. Note that if a stackÕs visible property is set in either the openStack or preOpenStack handlers, then this will override the expected behaviour of the go visible and go invisible forms. Any visual effects that have been queued with the visual effect command are displayed when the go command is executed (unless the screen is locked).
The go... as sheet form was introduced in version 2.0. Previous versions did not support sheet dialogs. | ||||||||||||||||||
Tags | navigation |