GoSiblingBlockPrevious

The currently selected block in the document layout is changed to the previous sibling block at the same level in the structure. The number of siblings moved is determined by the input parameter. This action uses the document block layout that is created by the DocumentAnalytics actions.

Important: This action is currently released as a preview. If you use this action in your application, you might need to make updates to your application if a new version of this action released.

Syntax

bool GoSiblingBlockPrevious (string count)

Parameters

string count

count: The number of sibling blocks to move. Smart parameters are supported.

Returns

True if the sibling is found at the location specified from the currently selected block. Otherwise, False.

Level

Page or field.

Details

When a sibling block is selected, the currently selected block becomes the sibling block and the currently selected word is changed to the first word in the new block, and that word might be in a nested block. Any searches that look for the next instance will start from the location of this selected word.

For example, if the currently selected block is a line and the parameter is two, then the currently selected block will move up two lines in the structure. If there is no sibling at that location, then the current block is not changed and the action returns false.

Example

RegExFind_InBlock("Da.e")
SelectParentBlockType("Block")
GoSiblingBlockPrevious("2")
RegExFind_InBlock("Qty")

This example will find the matching text for the regular expression Da.e, then select the parent block of type Block. The example then moves up two blocks of type Block. Now, the currently selected block is a type block and the currently selected word is the first word in that block. Then another search is performed within that new block for Qty. If Qty does not exist within the bounds of that new block, the action will return false.