OPENDLGFILELOADCALLBACK

#include "l_bitmap.h"

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

LPOPENDLGFILEDATA lpFileData;

/* pointer to a structure */

L_INT nTotalPercent;

/* total completion percentage */

L_INT nFilePercent;

/* completion percentage for a single file */

L_VOID L_FAR * lpUserData;

/* pointer to additional parameters */

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

Parameter

Description

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.

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.

nFilePercent

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

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

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

See Also

Functions:

LTCOMMDLGHELPCB

Topics:

Dialogs: Callback Functions

Example

For an example, refer to L_DlgOpen.