References ▼
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. | |