Porovnávané verzie
porovnané s
Kľúč
- Tento riadok sa pridal
- Riadok je odstránený.
- Formátovanie sa zmenilo.
LST_CREATE actions
Function
Action creates a list of objects according to entered criteria.
Declaration
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
LST_CREATE mask, objType, logGroup, sortBy, lines, h, data[, relation, object] |
Parameters
| mask | in | Identifier of String type - loads only those object which has the attribute "Name" complying with mask. If symbol "*" is in the mask, objects are included into list regardless of their name ("Name" attribute). | ||||||||||||||||||
| objType | in | Identifier of Int type - defines a type of objects which will be included into list (selection the one of predefined constants with prefix @OTYPE_*). If constant @OTYPE_ALL_TYPES has been chosen, objects of all types are included into list. | ||||||||||||||||||
| logGroup | in | Reference to object - if current value of parameter is non-associated alias, the parameter does not take into account. If parameter contains the reference to real object in system, only objects, belonging to entered logical group, will be included into list. | ||||||||||||||||||
| sortBy | in | Identifier of Int type - defines a way to sort the objects in list (selection the one of predefined constants with prefix @SORT_LIST_*). | ||||||||||||||||||
| lines | in | Identifier of Int type - maximum number of rows which will be written into data. It represents number of rows on one page. Maximum rows can be 1000. | ||||||||||||||||||
| h | out | Identifier of Int type - unique handle on created list of objects. If the handle is 0, some error occurred at list creating. | ||||||||||||||||||
| data | out | Identifier of the whole local structure SD._System_ObjectInfo or other structure definition consisting of the same column count and types. Types and meaning of columns:
It is possible to use a structure extended by 2 more columns with their types and meanings:
| ||||||||||||||||||
| relation | in | Identifier of Int type - defines the relationship among all objects in list in regard to object characterized by parameter object. Value of parameter must be defined by value of some of the constants REL_*. If the parameter has value REL_NONE or REL_NOTUSED, object defined by parameter object is ignored. | ||||||||||||||||||
| object | in | Reference to optional object - relative object. |
Description
Action creates the list of objects according to entered criteria. If the handle is 0, some error occurred at list creating.
The list belongs to a running scrip instance and it cannot be shared among various scripts. The list terminates together with script ending or by LST_CLOSE action.
Note
It is able to access the current values of objects that are loaded within the *current* page by the actions LST_CREATE, LST_GO_NEXT, ... The action ON CHANGE reacts to changes in object values. When the list is closed, or when page number is changed, only the most recent values are accessible and the ON CHANGE action stops responding to value changes.
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
; Spracovanie zmeny hodnoty PROCEDURE ProcChangeProc(IN INT _v, IN ALIAS _a, IN INT _row, _col) _c := _v END ProcChangeProc INT _h ; identifikátor zonamu INT _hbj ; identifikátor prvého objektu zo stránky ENTRY GO_OnClick ALIAS _a RECORD NOALIAS (SD._System_ObjectInfo) _data ; otvorenie zoznamu a načítanie prvej stránky LST_CREATE "Sec", @OTYPE_ALL_TYPES, (0), @SORT_LIST_NAME, 1000, _h, _data ; Prístup k aktuálnej hodnote objektu zo stránky _hbj := _data[1]^ID SET _a AS (_hbj) _value := _a ; Registrácia procedúry ON CHANGE (_hbj) GOTO ChangeProc END GO_OnClick ; zatvorenie zoznamu ENTRY GO_CLOSE_OnClick LST_CLOSE _h END GO_CLOSE_OnClick |