UpdateFieldWithBlock

Updates the current DCO object's field zone coordinates with the coordinates of the currently selected block. The text of the field will be set with the contents of the text bound by the currently selected block in the document layout. Uses the document block layout 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 UpdateFieldWithBlock ()

Parameters

None.

Returns

True if the word or phrase is located on the page. Otherwise, False.

Level

Field level only.

Details

UpdateFieldWithBlock updates the current DCO object's field zone coordinates with the coordinates of the currently selected block. The text of the field will be set with the entire text within the currently selected block in the document layout.

Example

RegExFind_InBlock("Da.e")
SelectParentBlock()
SelectParentBlock()
UpdateFieldWithBlock()

RegExFind_InBlock looks for the first occurrence of a word or phrase that matches the regular expression. If a match is found, the next action will change the currently selected block from the found word to the entire line that contains the word. SelectParentBlock is then called again to change the selected block to the parent of the current line, likely a paragraph. Then the current field zone is updated to contain the entire set of lines contained in the current block and the field value is set to all of the text within the current block.