Silverfrost Logo About Us | Contact Us
 

%re - Multiline Edit Box

Purpose

To create an multi-line edit box and display a character variable (i.e. a string).

Syntax

winio@('%N.Mre[options]', buffer)
winio@('%~N.Mre[options]', buffer, grey_ctrl)
character*(*) buffer     (input/output)
integer grey_ctrl     (input)

Modifiers

Grave accent (`) - makes the control read-only (scroll bars are disabled).

Caret (^) - the call-back is called when a change is made.

Question mark (?) - a help string is supplied.

Tilde (~) - adds a variable that controls the grey (enable/disable) state.

Description

This control is similar to %rs but is multi-line. It has a buffer limit of 32K characters.

N represents the width of the box in average characters. M represents the depth which should not be less than 2.

buffer is a character string for the text (maximum of 32*1024 characters).

The following options are available:

UPPERCASE

Alphabetical characters (a . . z) are converted to upper case and displayed and stored as upper case.

LOWERCASE

Alphabetical characters (A . . Z) are converted to lower case and displayed and stored as lower case.

CENTRE_TEXT

Text is always centred on every line.

RIGHT_TEXT

Text is right justified on every line (the default is left justified text).

NO_HSCROLL

The text will not scroll to the right past the end of the window. The text will auto wrap.

NO_VSCROLL

The text will not scroll beyond the bottom of the window.

HSCROLLBAR

A horizontal scroll bar is added - do not use with NO_HSCROLL.

VSCROLLBAR

A vertical scroll bar is added - do not use with NO_VSCROLL.

KEEP_FOCUS

When the user tabs between windows, normally the focus will be lost, however with KEEP_FOCUS the selected text will remain selected.

NO_ADDITIONAL_DEPTH

Removes the standard spacing between this control and the next line.

Notes

The %rs PASSWORD option is not available with %re. %re does not take a pivot (%pv). %co can be used with %re.

See also

%rs - Edit String, %eb - Edit Box, %co - Options for Edit


 

 

 

Copyright © 1999-2017 Silverfrost Limited