LEADTOOLS Common Dialog C++ Class Library Help > Quick Reference > Data Types > PICTURIZEDLGPARAMS |
typedef struct _PICTURIZEDLGPARAMS
{
L_UINT uStructSize;
pBITMAPHANDLE pBitmap;
L_TCHAR * pszPath;
L_INT nCellWidth;
L_INT nCellHeight;
L_UINT uResize;
L_INT nBitmapWidth;
L_INT nBitmapHeight;
L_UINT32 uDlgFlags;
LTCOMMDLGHELPCB pfnHelpCallback;
L_VOID *pHelpCallBackUserData;
} PICTURIZEDLGPARAMS, * LPPICTURIZEDLGPARAMS;
The PICTURIZEDLGPARAMS structure provides information used to initialize the dialog box created by the LDialogImageEffect::DoModalPicturize function. After the user closes the dialog box, this structure is updated with information about the user's selections.
Member |
Description |
|
uStructSize |
Size of this structure, in bytes. Use the sizeof operator to calculate this value. |
|
pBitmap |
Ignored. |
|
pszPath |
A string that contains the full path to the directory that contains the images. Only images from this directory will be used. Images in any subdirectories will NOT be used. |
|
nCellWidth |
A variable to be updated with the width of the images used to reconstruct the image. Possible values range from 1 to nBitmapWidth. |
|
nCellHeight |
A variable to be updated with the height of the images used to reconstruct the image. Possible values range from 1 to nBitmapHeight. |
|
uResize |
Flags that control the behavior of the process. Possible values are given below. These values can be combined using OR (|). |
|
|
Value |
Meaning |
|
PICTURIZE_RESIZE |
[0x0002] Resize the images that are not the required size. |
|
PICTURIZE_RESAMPLE |
[0x0004] Resample the images that are not the required size. |
|
PICTURIZE_ONCE |
[0x0010] Use the image only once throughout the process. |
|
PICTURIZE_EQUALUSAGE |
[0x0020] Use all images equally. That is, before an image will be used twice, all other images must be used at least once. |
|
PICTURIZE_BESTFIT |
[0x0040] Images will be resized to fit the image if the bitmap width or height is not a multiple of nCellWidth/nCellHeight. |
|
0 |
The picturize process will not use any of the above flags. It will: reload all the files each time you look for a rectangle to substitute and ignore all the images present in pszPath if their size is not nCellWidth x nCellHeight |
nBitmapWidth |
A variable to be updated with the maximum possible cell width. The value must be greater than zero. |
|
nBitmapHeight |
A variable to be updated with the maximum possible cell height. The value must be greater than zero. |
|
uDlgFlags |
User interface flags for this dialog, which determine the layout and action of the dialog. Possible values are: |
|
|
Value |
Meaning |
|
DLG_PICTURIZE_SHOW_CONTEXTHELP |
[0x00000002] dialog should contain a context sensitive help icon. |
pfnHelpCallback |
Ignored. |
|
pHelpCallBackUserData |
Ignored. |