OPENDLGFILELOADCALLBACK

Summary

Lets you update a status bar or interrupt the L_DlgOpen function operation.

Syntax

L_INT pEXT_CALLBACK YourFunction(lpFileData, nTotalPercent, nFilePercent, lpUserData)

Parameters

LPOPENDLGFILEDATA lpFileData

Pointer to an OPENDLGFILEDATA structure that contains loading data for the file currently being loaded. The data in this structure is read only information.

L_INT nTotalPercent

An integer that indicates the completion percentage for loading all selected files in the Open dialog. This value will be updated every time a file finishes loading. Valid values range from 0 to 100.

L_INT nFilePercent

An integer that indicates the completion percentage for loading a single file from the selected files. Valid values range from 0 to 100.

L_VOID * lpUserData

A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the lpUserData parameter of the calling function.). Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

Required DLLs and Libraries

• LTDLGIMGEFX
• LTDLGKRN
• LTDLGUTL
• LTDLGCTRL
• LTDLGCOM
• LTDIS
• LTIMG
• LTKRN
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions

• LTCOMMDLGHELPCB

Topics

• Dialogs: Callback Functions

Example

For an example, refer to L_DlgOpen.