DBselectObjectsByObjectlist |
Top Previous Next |
|
Objects to Objekthandle select. With this procedure objects are treated to Objekthandles as a selection criterion. A total of four selection constants are available. With OR become the objects whose Objekthandles in the object list seem to the existing selection amount added, with AND will leave only such objects in the selection amount which also fulfil the new criterion or lie in another segment. With NEED only the objects will leave in the selection amount which do not fulfil the new criterion. With NEW the old selection amount is emptied and the objects which fulfil the new criterion are added to the selection list. The criterion for fulfilling the new selection condition is present that the trading of the object is performed in the list of the Handles. The list can be long arbitrarily and may contain double entries. Parametre root (PROOT) [IN] The trading of the data bank, it all segments with the Flag selectable are considered. fkt (SELECT_FUNKTION) [IN] Four different constants are available: SELECT_NOT An object is removed from the selection list if it owns a trading from the object list. SELECT_OR An object is taken up in the selection list if it owns a trading from the Handleliste. SELECT_NEW The selection list is emptied and then the objects are taken up in the list which own a trading from the object list. SELECT_AND An object is removed from the selection list if it does not seem in the object list. objects (POBJECT *) [IN] Pointer on a list with the Handles of all objects which should be looked. objCnt (int) [IN] The length of the object list. The size which is given in objCnt may not be bigger, than the number of the objects in objects. The value from objCnt may not be negative. Result (T_ERROR) [OUT] If the procedure was explained perfectly, is the result ERROR_OK, but one of the error messages from error.h. Declaration #include "database.h"
T_ERROR DLLENTRY DBselectObjectsByObjectlist ( PROOT root, SELECT_FUNKTION fkt, POBJECT * objects, int objCnt ); Related functions
|