Link Command

The Link command is similar to the Call command except that Lightwing branches to a page in another script, instead of a page within the current script. Also, only a single branch target can be defined, instead of a list of pages. The Link command requires a script name (which may also include a path) followed by an optional page name. If the page name is omitted, the first page in the script will be the branch target. The referenced scripts should be in a scripts folder which can be the current scripts folder or a different folder specified by either an absolute or relative file path. Most of the same command options available for the Call command can also be used with the Link command, except for the index option.

Examples of Absolute and Relative Script File Paths

        Script File Paths                                                   Path Types
    
        scripts/Default.lws                                                  Current Folder
        /home/root/lightwing/scripts/Default.lws          Absolute
        demos/lightwing/scripts/Default.lws                  Relative

The Jump, Call, Chain and Link commands feature options to make branching conditional.  Lightwing branches only if all of the defined conditions are true, otherwise execution continues with the next consecutive page in the current script.

Example of a Page that Links only on Mondays

page: FirstPage
    link: MondayPage    day: Monday

Day Option

Defines a specific day and/or time condition on which a branch will be taken.  This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The maximum number of conditions is 8 per page.

Time Condition Examples

    Examples                                              Occurrences

    12:00PM                                                   Every day at Noon.
    Monday                                                    Every Monday at Midnight.
    Tuesday 12:00PM                                   Every Tuesday at Noon.
    Wednesday January 12:00PM              Every Wednesday in January at Noon.
    1/1/2015                                                   First day of 2015 at Midnight.

Before Option

Defines a specific day and/or time condition before which a branch will be taken. This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The date and time syntax is the same as shown for the day option above.

After Option

Defines a specific day and/or time condition after which a branch will be taken. This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The date and time syntax is the same as shown for the day option above.

Portrait Option

Defines a display orientation condition that must be met for the branch to be taken. This parameter must be either on or off.  The default is off, which means the display must have a landscape orientation for the branch to be taken. Otherwise, on means the display must have a portrait orientation for the branch to be taken.

 

 

<   Jump Command                                             Introduction                                            Object Command   >