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 */ |
/* 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: |
|
Topics: |
Example
For an example, refer to L_DlgOpen.