MEMOEDIT()

From Recital Documentation Wiki
Revision as of 11:39, 23 March 2009 by Yvonnemilne (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Class

Memos


Purpose

Function to edit a memo field or character string in a pop-up window


Syntax

MEMOEDIT(<memofield | expC1>, [<expN1>, <expN2>, <expN3>, <expN4> [,<expL>, [<expC2>]]])


See Also

HARDCR(), MEMLINES(), MEMOLINE(), MEMOREAD(), MEMOTRAN(), MEMOWRITE(), MLCOUNT(), MLINE(), SET CLEAR, SET MEMOFORMAT, SET MEMOWIDTH, SET MEMOWINDOW, TEXTEDIT()


Description

The MEMOEDIT() function allows the <memo field> or character expression <expC1> to be edited in a 'pop-up' window. If a <memofield> is used with MEMOEDIT(), the function will return .T. if the memo was modified and .F. otherwise. If <expC1> is used in MEMOEDIT(), the function returns the character string.

Coordinates <row>, <col> to <endrow>, <endcol>, may be optionally specified by <expN1> to <expN4>. If no screen coordinates are specified, MEMOEDIT() will default to the current SET MEMOWINDOW specifications.

If the optional update parameter <expL> is .T., the memo can be modified. If <expL> is .F., the memo can only be viewed (e.g. in help messages). Record locks are automatically applied if UPDATE is ON.

The optional expression <expC2> is used to border the pop-up window and label it with the character expression.

Once a pop-up window has been activated, pressing the [HELP] key displays a menu of memo editing keys. These keys include facilities for reading from and writing to external files, and printing on the system printer. In UNIX/Linux, you may pop-up a command window by pressing the [MENUBAR] key and the letter {C} simultaneously. Operating system commands may be typed into the window, the results of which are read into the memo. You may stuff the keyboard with operating system commands by enclosing the command in single quotes.

The functions MEMOREAD() and MEMOWRITE() are used for reading text files to and from memo fields. The MEMOLINE() and MLINE() memo editing functions are used to extract a line of text from a memo field. Reading text files into memo fields is strongly recommended for enabling users to edit text files from within applications.

Text files can be edited directly within the same type of window as MEMOEDIT() by using the TEXTEDIT() function. Please note that memo-editing functions will not work with text files, and text-editing functions will not work with memo fields. An external Word Processor can be defined for the editing of memo fields when the [FIELD EDIT] key is pressed in forms (see the SET WP command for more information).

The SET MEMOFORMAT ON | OFF command is active with MEMOEDIT(), determining whether memo text is formatted during and after editing operations. If SET CLIPPER is ON then MEMOEDIT() provides full syntax capability with Clipper.


Example

memoedit(notes, 5, 10, 20, 70, .T., "Notepad")


Products

Recital Terminal Developer