Syntax


UP    | 

DOWN  |

LEFT  |

RIGHT 

[ number |

  PAGE   |

  HALF   |

  DATA   |

  FULL   |

  MAX    |

  CSR    ]


Operands


number

The number of lines or columns to scroll; may be one to four digits.


PAGE

Scroll by the number of text lines on the screen (vertical) or the number of columns (horizontal). If the current file Profile is set to EOL AUTO or EOL AUTONL, then the scroll will be to the relative =PAGE> line of the previous/next page. 


FULL

Same as PAGE except it will always ignore the EOL AUTO and  EOL AUTONL settings.


HALF

Scroll the screen one half the screen width/height.


DATA

Scroll the screen one screen width/height minus 1 line/column.


MAX

Scroll the screen all the way to the top/bottom/left/right of the data depending on the scroll direction.


CSR

Scroll the screen so the line/column where the cursor is currently located becomes the relative left/right/top/bottom of the screen depending on the scroll direction. If the cursor is not currently located within the text area, this is treated as PAGE.

 

Abbreviations and Aliases

 

PAGE can also be spelled as P

FULL can also be spelled as F

HALF can also be spelled as H

DATA can also be spelled as D

MAX can also be spelled as M

 

Description


The four scroll commands are used to reposition the screen display to a different portion of the data being edited. Normally these commands are assigned as defaults of one or more keyboard keys. The UP/DOWN keys may not need to be further tailored by the user in KEYMAP, because they are assigned default mappings to the PageUp and PageDn keys at installation time.


Since standard command key processing always prefixes the command line with whatever command key is pressed, the operands are normally entered on the command line and then the command Key is pressed.


For example, to scroll down to the bottom of the data being edited:


    • Enter MAX or M on the command line
    • Press the key for DOWN (usually the PageDn key)
    • The resulting command issued internally would become DOWN MAX and the screen would be positioned at the bottom of the data


If no operand is entered, the command will use the value from the Scroll field in the upper right corner of the screen. The value of this field may be changed at any time to any valid scroll operand and it will remain the default until you change it again.


When scrolling commands are mapped to keys, it is useful to have them prefixed with ! exclamation. That will cause any existing command in the primary command area to be cleared out first. Doing that will help prevent the scroll command from being "combined" with anything left over in the command line, which would result in an SPFLite command syntax error.


Because scrolling to the top and bottom of a file is frequently needed, it is useful to have UP MAX and DOWN MAX mapped to keys. A helpful mapping may be to have either Alt PageUp or Ctrl PageUp mapped to !UP MAX, and Alt PageDn or Ctrl PageDn mapped to !DOWN MAX.


Created with the Personal Edition of HelpNDoc: Simplify Your Help Documentation Process with a Help Authoring Tool