Loading...
 

StepForw

StepForw

StepForw(stmtName)

parameters: Name of an instruction (InstantView macro!)

Stack
Stack Position Description
Stack(In) Top an object box
Stack(Out) Top -

This instruction is essentially the same as Iterate, applied to an object box. The iteration starts with the (last) interactively selected element. If no targets are currently selected, StepForw has no effect. For an object box with the flag SELECT_MULTIPLE the last selected object is taken into account. Widget brings an object box onto the stack.

// Define the macro, that must be called as parameter by StepForw
Define(SelectEntryAbove)
  Var(counter)
  // Deselect all entries of the list
  DeselectAll(, ListBox)
  // Select the actual entry in the list
  Select(, ListBox)
  // Count the selected entries
  Incr(counter)
;

// Imagine, there is a ListBox, where an entry at the top is selected.

// Set counter to 0

0 -> counter
// Now this command will be executed...
Widget(, ListBox) StepForw(SelectEntryAbove)
// One line after another will be selected and counted, until the last entry in the list is reached!

 

// At the end, show the user, how many lines have been underneath the selected entry!
T("Zeilen unter selektierter Zeile: ", "Lines underneath selected entry: ") String counter String + Attention(EndTXN)

See also