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

More information

PRT Object Model member list.