ProviewR Programmer's Reference Manual
V6.1.4
|
Functions | |
pwr_tStatus | nmpsappl_MirrorInit (pwr_tString80 *cell_array, unsigned long options, nmpsappl_t_ctx *ctx) |
Initialize mirroring. More... | |
pwr_tStatus | nmpsappl_Mirror (nmpsappl_t_ctx applctx, int *data_count, nmpsappl_t_datainfo **datainfo) |
Update mirroring. More... | |
pwr_tStatus | nmpsappl_RemoveData (nmpsappl_t_ctx applctx, pwr_tObjid objid) |
Removes a dataobject from one of the cells that are mirrored. More... | |
pwr_tStatus | nmpsappl_RemoveAndDeleteData (nmpsappl_t_ctx applctx, pwr_tObjid objid) |
Removes and deletes a dataobject from one of the cells that are mirrored. More... | |
pwr_tStatus nmpsappl_Mirror | ( | nmpsappl_t_ctx | applctx, |
int * | data_count, | ||
nmpsappl_t_datainfo ** | datainfo | ||
) |
Update mirroring.
nmpsappl_Mirror mirrors the content of one or several cells into an application program.
The function handles direct link of cells and dataobjects, and returns a list of data objects to the application together with information about front, back, select properties, and which data objects are new or has disappeard. The application also receives a pointer to each data object.
The mirroring is initiated by calling nmpsappl_MirrorInit. The cells are mirrored are specified in this call. Then nmpsappl_Mirror is called cyclic to recieve the current content of the cells. All the dataobjects found in the cells are placed in an array, and the order the cells was specified in nmpsappl_MirrorInit determines the order in the dataobject array.
Several mirroring can be handled in the same application (max 32), and each mirroring can handle maximum 32 cells.
Example
applctx | Context for nmpsappl mirror. |
data_count | Number or data object in the array. |
datainfo | Data strucure with dataobjects found in the cells. |
Definition at line 449 of file nmps_appl.c.
pwr_tStatus nmpsappl_MirrorInit | ( | pwr_tString80 * | cell_array, |
unsigned long | options, | ||
nmpsappl_t_ctx * | ctx | ||
) |
Initialize mirroring.
nmpsappl_MirrorInit initiates a mirroring by specifying the cells that should be mirrored.
Use nmpsappl_Mirror to fetch the mirrored data structure.
The option argument is a bitmask where the bits specifies different functions in nmpsappl_mirror:
cell_array | A string array with the names of the cells that should be mirrored. The element after the last cellname should be a NULL string. |
options | Bitmask specifying options for the mirroring. |
ctx | Context pointer. |
Definition at line 245 of file nmps_appl.c.
pwr_tStatus nmpsappl_RemoveAndDeleteData | ( | nmpsappl_t_ctx | applctx, |
pwr_tObjid | objid | ||
) |
Removes and deletes a dataobject from one of the cells that are mirrored.
applctx | nmpsappl mirror context. |
objid | Objid for the data object that is to be removed. |
Definition at line 720 of file nmps_appl.c.
References EVEN, and gdh_DeleteObject().
pwr_tStatus nmpsappl_RemoveData | ( | nmpsappl_t_ctx | applctx, |
pwr_tObjid | objid | ||
) |
Removes a dataobject from one of the cells that are mirrored.
applctx | Context for nmpsappl mirror. |
objid | Objid for dataobject that is to be removed. |
Definition at line 681 of file nmps_appl.c.