Textmodule Selection with Multiselect

This module holds the logic for the access to the TXM database table. The functions are used by small module where a separate instance is used for every field which shall be loaded with text from text module. (e.g. TXBBUT and TXSBUT)

TXSMOD facilitates the multiple selection of text modules assigned to a particular text field. If only single text modules are required, use module TXMMOD instead of TXBBUT or TXSBUT (see below).

The main features include:

• connecting to text block or stream
• a button to load text modules
• inserting multiple text module in a specified sequence in one go
• replacing field references (enclosed in '{' and '}' ) on loading (*)
• checking size limits of blocks
• specifying size limits independant of the concrete field size
• requesting a specific language for the text module
• checking that text modules in the corresponding language are loaded
• autogenerating entries in the TXMTXT CodeTable for specified text module groups not in the CodeTable

(*) TXSBUT and TXBBUT support the deactivation of the block resolution of {}references. If a hyphen '-' is the first character entered in TXMBASGRP (indicating the block in which references are to be resolved), the field reference is not resolved immediately. This means that changes made to the contents of the field will not amend block content straight away. This will only be done when the block is either displayed or saved.

The logic is split between one central module (TXSMOD) comprising the core functionality and smaller, type-specific modules brought into the transaction in a separate instance for each field textblock loaded.

To use the functionality, the following steps need to be taken:

• add instance of TXBBUT or TXSBUT, depending on field type using a suitable instance name (normally indentical with the text module group)
• link in the target field into TXMBLOCK / TXMSTM of instance
• specify the text module group, normally as constant value in argument TXMGRP
• position the BUTTXMSEL button in the upper right corner of the target field on a panel
• as an option, add logic to fill the requested language in the field TXMUIL
• as an option, add logic to set the maximum text size into MAXLEN / MAXLIN

Note: All available module groups can be maintained in DBITXM and the codetable TXMTXT identifying the text module groups can be maintained in SYSTBL.

Holds the numeric coded datatype of the argument. (tdDatatypeBlock or tdDatatypeStream)

Optional field which might be filled with the module which shall be the base for resolving field references. The default base is the group of the passed target field.

A nonempty value disables the automatic resolution of embedded references (e.g. {LIDGRP\REC\OWNREF}). This field is filled with the flag character used at the first position of TXMBASGRP within the calling TXSBUT/TXBBUT instance. Currently supported is “-” and “*” to disable the automatic resolution. Field references flagged with “*” are only resolved when a explicite call to GetTxmBlockFill is executed Field references flagged with “-” are not resolved by TXSMOD

reduce passed text to maximum line length and maximum number of lines
as configured in the originating text handling module instance
ArgTxt holds the text to be handled
ArgPth holds the full module path of the originating instance of TXBBUT or TXSBUT
ArgCnt is a InOut argument where the available number of lines might be passed.
if no old text exists pass -1.
On return the remaining number of lines available or the negativ number
of cut of lines is returned

Get text module at any passed language.
If passed language is empty and more than one text module is matching
the criteria, nothing will be returned.

ArgStm holds the stream of all selected text modules