OnLoadInfo event (Main Control)

Remarks

Occurs if LEADTOOLS attempts to load an image file, but does not find valid format information in the file header. You can use this event for loading input data (such as raw fax) that LEADTOOLS cannot recognize.

This event is generated only if the EnableLoadInfoEvent property is set to TRUE before loading an image file.

LEADTOOLS will only attempt to recognize fax files if you respond to this event and have filled the LoadInfoXXX properties listed below. If you want LEADTOOLS to automatically recognize any fax file, set the LoadInfoWidth and LoadInfoHeight properties to -1 once, at the beginning of the program. If you recognize the file and know the width and height of the file, set LoadInfoWidth and LoadInfoHeight to a positive value.

This event occurs before an error message is generated. You can set the following properties in this event to supply the missing header information:

LoadInfoBits property

LoadInfoFlags property

LoadInfoFormat property

LoadInfoHeight property

LoadInfoOffset property

LoadInfoWidth property

LoadInfoXRes property

LoadInfoYRes property

UserPalette property

You can also set these properties elsewhere in your program. For example, you could set them at the time you identify the file that is to be loaded. But LEADTOOLS does not check the property values until after it has failed to find the header information and the OnLoadInfo event has occurred.

See Also