hotkeys

Definition/Update Processor, Releases: AP

Calls Pick/BASIC subroutines from AP dictionaries.

Description

allows calling Pick/BASIC subroutines from dictionaries using the UP command '<ctrl>+xnumber', where 'number' is a number between '0' through '9'.

There are 11 dictionary attributes in both the file-defining and attribute-defining items related to 'hotkeys'. They are defined as 'hotkey.all', 'hotkey0', 'hotkey1', etc., through 'hotkey9'.

Hotkey subroutine calls are available in addition to subroutine calls from 'output-conversion', 'correlative' or 'input-conversion'.

To call a Pick/BASIC subroutine while in the Update processor on a particular attribute, type '<ctrl>+xnumber'.

Only the program(s) on one dictionary will be executed by each command. There may be more than one subroutine called on an attribute. (Use '<ctrl>+v' to multi-value call statements.)

The subroutine that gets executed is dependent on the following set of priorities:

If there is a subroutine called on 'hotkey.all' (attribute 20) in the current attribute-defining item, it will be executed, regardless of the value of 'number'.

If there is not a subroutine called on 'hotkey.all', the subroutine called on attribute<20> + 'number' of the current attribute-defining item will be executed . Note: If 'number' = '0', the subroutine on 'hotkey.0' (attribute 30), if present, will be executed.

If there are no subroutines called in the attribute-defining item, the file-defining item is used.

If there is a subroutine called on 'hotkey.all' (attribute 20) in the file-defining item, it will be executed, regardless of the value of 'number'.

If there is not a subroutine called on 'hotkey.all', the subroutine called on attribute<20> + 'number' of the current file-defining item will be executed . Note: If 'number' = '0', the subroutine on 'hotkey.0' (attribute 30), if present, will be executed.

The following table illustrates the rules by which hotkey references are interpreted.

Att# Dict.name Subroutine call UP command
<20> hotkey.all call default <ctrl>+x<0-9>
<21> hotkey1 call one <ctrl>+x1
<22> hotkey2 call two <ctrl>+x2
<23> hotkey3 call three <ctrl>+x3
<24> hotkey4 call four <ctrl>+x4
<25> hotkey5 call five <ctrl>+x5
<26> hotkey6 call six <ctrl>+x6
<27> hotkey7 call seven <ctrl>+x7
<28> hotkey8 call eight <ctrl>+x8
<29> hotkey9 call nine <ctrl>+x9
<30> hotkey0 call zero <ctrl>+x0

Example

:ud filename test
dictionary-code a
attribute-count 5
substitute-header
structure
output-conversion
correlative
attribute-type l
column-width 20
input-conversion
macro
output-macro
description
hotkey.all
hotkey1 call list.states
call list.country
hotkey2
hotkey3
hotkey4
hotkey5
hotkey6
hotkey7
hotkey8
hotkey9
hotkey0

In this example, when the operator enters '<ctrl>+x1' from the
attribute 'test', the subroutines 'list.states' and
'list.country' are executed. After 'list.country'
completes, control returns to UP and remains in the item 'test'.

See Also

Command Name Type Description
output-conversion Attribute Defining Item References attribute 14 of a dictionary.
correlative Definition References attribute 8 of dictionary.
input-conversion Attribute Defining Item References attribute 14 of a dictionary.
up.x Command Exits item or calls subroutines.
attribute.defining.items Introductory An overview of attribute-defining items.
hotkey0 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey1 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey2 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey3 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey4 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey5 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey6 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey7 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey8 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
hotkey9 Attribute Defining Item Hotkey to call Pick/BASIC subroutine.
file.defining.items Definition File-defining item overview.
tcl.ud Verb: Access Updates dictionary of given file.
hotkey.all File Specifies the name of a subroutine to execute when a hot key is used.
up Introductory

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.