LEADTOOLS Common Dialog C DLL Help > Function References > L_DlgGetDirectory |
#include "l_bitmap.h"
L_LTDLG_API L_INT L_DlgGetDirectory (hWndOwner, pDlgParams)
L_HWND hWndOwner; |
/* owner of dialog */ |
LPGETDIRECTORYDLGPARAMS pDlgParams; |
/* pointer to a structure */ |
Displays the Get Directory dialog box, and allows the user to browse the file system for a folder/directory.
Parameter |
Description |
hWndOwner |
Handle of the window which owns the dialog. |
pDlgParams |
Pointer to a GETDIRECTORYDLGPARAMS structure to be updated with the values entered by the user, through the dialog. Set members of this structure, before callng this function, to set the dialogs initial values. |
Returns
SUCCESS_DLG_OK |
The "OK" button was pressed, and the dialog exited successfully. |
SUCCESS_DLG_CANCEL |
The "Cancel" button was pressed, and the dialog exited successfully. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
Required DLLs and Libraries
LTDLGFILE 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: |
|
Topics: |
|
|
Example
#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName L_INT DlgGetDirectoryExample(HWND hWnd) { L_INT nRet; GETDIRECTORYDLGPARAMS DlgParams; L_TCHAR szDirectory [ L_MAXPATH ]; memset ( &DlgParams, 0, sizeof ( GETDIRECTORYDLGPARAMS ) ) ; lstrcpy ( szDirectory, MAKE_IMAGE_PATH(TEXT(""))) ; DlgParams.uStructSize = sizeof ( GETDIRECTORYDLGPARAMS ) ; DlgParams.pszDirectory = szDirectory ; DlgParams.nBuffSize = L_MAXPATH ; DlgParams.pszFilter = TEXT("ALL\0*.*\0LEAD\0*.cmp\0JPEG\0*.JPG\0"); DlgParams.nFilterIndex = 1 ; DlgParams.pszTitle = TEXT("Select a Directory Please"); nRet = L_DlgInit (DLG_INIT_COLOR) ; if(nRet != SUCCESS && nRet != ERROR_DLG_ALREADYINITIATED) return nRet; nRet = L_DlgGetDirectory( hWnd, &DlgParams ) ; if(nRet < 1) return nRet; nRet = L_DlgFree () ; if(nRet != SUCCESS) return nRet; return SUCCESS; }