OmrHelper.BuildBubblesOnDemand property

Read-Write property.

Type: Boolean

For Image Scanners Only - 5000i and iNSIGHT scanners.

ScanTools Runtime always builds bubbles according to the application definition. If a response position or form ID is not defined in the application definition, ScanTools will not build a bubble at that position. However Link, by default independently builds all bubbles (all possible read head cells) on the form as well, potentially overriding the bubbles built by ScanTools. Link does this on first access to the OMR buffer at the SheetAcquired event. While ScanTools uses the bubble type specified in the application definition, Link builds the bubbles using the btBubble style. This behavior is for compatibility with Link 6.3 or earlier but is something that you may not desire.

Beginning with Link 6.4, solutions should preferably set this property to true at the SheetAcquired event at the very beginning of the event handler code. In this case, Link builds bubbles only when explicitly requested by the solution program by making a call to OmrHelper.BuildBubble.

NOTE: This property is always reset to false at the SheetAcquired event.

Valid

See ScanEventArgs and ScanningManager Events Valid Combinations.

IDL

[propget] BuildBubblesOnDemand([out, retval] VARIANT_BOOL* pVal);

[propput] BuildBubblesOnDemand([in] VARIANT_BOOL NewVal);

Values

See also