RefFrame.PalletIndex Property

refframe_object.PalletIndex Property

For a pallet reference frame, sets or gets the row, column or layer index for the next grid position to be accessed.

refframe_object.PalletIndex(row_col_lay) = <next_index>
-or-
…refframe_object.PalletIndex(row_col_lay)

Prerequisites

The refframe_object must be a pallet reference frame.

Parameters

row_col_lay

A required numerical expression that is equal to 1 if the row index is to be accessed, 2 if the column index is to be accessed, or 3 if the layer index is to be accessed.

Remarks

This property permits a program to set or get the next row, column, or layer index to be accessed in a pallet reference frame. Each index can range from 1 to the maximum value for that dimension as specified by the object’s PalletMaxIndex property. The row, column, and layer indices are always positive integer numbers. If you wish to step in a negative direction, the appropriate PalletPitch property for the refframe_object can be set to a negative number.

If you wish to set all 3 index values at once, you can make use of the object’s PalletRowColLay method. If you want to just advance to the next logical pallet position, the PalletNextPos method can be invoked.

By default, when a new pallet reference frame is created, the pallet indices are set to 1, 1, 1.

Examples

Dim ref1 As New RefFrame           ' Also allocates Loc
Dim loc1 As New Location
 
ref1.Type = 1                      ' Change to pallet frame
ref1.Loc.XYZ(100,50,-80,0,0,0)     ' Define pallet base
ref1.PalletPitch(1) = 10           ' Spacing along row
ref1.PalletPitch(2) = 20           ' Spacing along column
ref1.PalletMaxIndex(1) = 3         ' Define grid size
ref1.PalletMaxIndex(2) = 3         ' Define grid size
 
loc1.RefFrame = ref1               ' loc1.PosWrtRef all 0’s
ref1.PalletIndex(2) = 2            ' Set grid (1,2,1)
Console.Writeline(loc1.Pos.X)      ' Displays 100
Console.Writeline(loc1.Pos.Y)      ' Displays 70