PrtItem.MoveTo (Method)
Syntax
PrtItem.MoveTo destRegionId$, destLoc, insertFlag [ , comment$ ]
Description
Moves an item from its current location to a new location in a region (could be the same region.)
| Parameter | Description |
|---|---|
| destRegionId$ | String. Destination Region ID. The source Region ID is contained in the item object already. |
| destLoc | Integer. Location to move to in destination region. Sequence number of the item in the destination tracking region. Specified as PRT_FIRST (EXIT) or PRT_LAST (Entry), or a number from 1 to n, where n is the number of items in the queue. |
| insert_flag | Boolean. If true, the moved item is to be inserted in the destination region queue before the item located at the specified destination region location, unless the manifest constant last is specified, in which case the item is inserted after (behind) the last item currently present in the region. |
| comment$ | String (optional). An optional comment to write to the PRT log file. |
Example
Dim Region as new PRTREGION
Region.Id = SRC$
Region.GetItemList
' Set timestamp attributes for the head item in a region, and
' then move the item to another region.
DSUF$ = "_DATE"
TSUF$ = "_TIME"
Region.Item(0).Setattr SRC$ & DSUF$, DATE$
Region.Item(0).Setattr SRC$ & TSUF$, TIME$
Region.Item(0).Modify
Region.Item(0).Moveto DESTREGION$, RegionLOC%, 0