Document.Litho-code property

Read-Write property.

Type: BSTR

This property applies only if you define litho-code grids in your ScanTools Plus application. A litho-code is an optional, binary-coded serial number unique to every form. It is a pre-printed grid that is used to check that all sheets in a booklet are from the same individual document. Refer to ScanTools Plus Help for how to do this.

When reading this property

If the document does not have a litho-code defined, an exception is thrown. Otherwise a string is returned. If this string is empty, it implies that the document is not yet, or could not be identified by ScanTools. Otherwise it contains the resolved value – this is typically numeric.

It makes sense to read this property beginning at the Resolved event thru the DocComplete event.

When writing to this property

This is permissible to write to this only when the document could not be identified; the ScanError event is fired and you wrote to the Document.DocumentNumber property as the first part of the process of programmatically identifying an unscannable document. Writing the litho-code is the second part of the process – do this only if the document has a litho-code defined. To see if a litho-code is defined, attempt to first read this property. If an exception is thrown, there is none. If it is an empty string, it has a litho-code defined and you must write to this property. Zero padding at the left is automatically performed for strings shorter than the length defined in the application definition.

Before leaving the ScanError event handler you must call ScanningManager.SetScanErrorResolution with a parameter of L_SCANERROR_RESOLUTION_IGNORE_ERROR to make your document identification effective within ScanTools. This concludes the process of programmatically identifying the document.

Valid

See ScanEventArgs and ScanningManager Events Valid Combinations.

IDL

propget, HRESULT Lithocode[out, retval] BSTR* pVal);

propput, HRESULT Lithocode[in] BSTR newVal);

Exceptions

Application has no litho-code grids for this document

DocumentNumber is not valid; as when ScanTools just failed to identify the document

Document was already identified by ScanTools

The value is too long per the application definition

You tried to write to this property at any point other than the ScanError event