hotkeys

hotkeys


double-clutching Index Level processing codes
Syntax
Category Update processor
Type Definition
Description allows calling FlashBASIC 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 FlashBASIC 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
Options
See Also output-conversion correlative input-conversion x attribute-defining items hotkey0 hotkey1 hotkey2 hotkey3 hotkey4 hotkey5 hotkey6 hotkey7 hotkey8 hotkey9 file-defining item ud hotkey.all Update processor (UP)
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".
Warnings
Compatibility D3 7.0 AP
double-clutching Index Level processing codes