typedef struct _ZOOMWAVEDLGPARAMS
{
L_UINT uStructSize;
pBITMAPHANDLE pBitmap;
L_BOOL bZoomToFit;
L_UINT uAmplitude;
L_UINT uFrequency;
L_INT nPhase;
L_UINT uZoomFactor;
POINT ptCenter;
COLORREF crFill;
L_UINT uZoomWaveFlags;
L_UINT32 uDlgFlags;
LTCOMMDLGHELPCB pfnHelpCallback;
L_VOID *pHelpCallBackUserData;
} ZOOMWAVEDLGPARAMS, * LPZOOMWAVEDLGPARAMS ;
The ZOOMWAVEDLGPARAMS structure provides information used to initialize the dialog box created by the LDialogImageEffect::DoModalZoomWave function. After the user closes the dialog box, this structure is updated with information about the user's selections are returned in this structure.
Member | Description | |
uStructSize | Size of this structure, in bytes. Use the sizeof operator to calculate this value. | |
pBitmap | Ignored. | |
bZoomToFit | Flag that indicates the initial zoom level for previewing the image. Possible values are: | |
Value | Meaning | |
TRUE | Set the initial zoom level to "Zoom to fit". | |
FALSE | Set the initial zoom level to "Normal (1:1)". |
uAmplitude | Zoom wave magnitude. The value must be greater than zero. | |
uFrequency | The number of repeated waves along the radial line.The value must be greater than zero. | |
nPhase | Wave phase shift. The valid range is from −36000 to 36000. | |
uZoomFactor | The percentage the wave grows as it moves from the image center. The valid range is from 0 to 100. | |
ptCenter | POINT structure that contains the center point from which the wave is zoomed. The center point must be defined inside the bitmap, or inside the region, if the bitmap has a region. | |
crFill | The COLORREF value that specifies the fill color of undefined area. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color. | |
uZoomWaveFlags | Flags that indicate how exposed areas will be handled. Possible values are: | |
Value | Meaning | |
FILL_CLR | [0x0000] fill exposed areas with the color in crFill. | |
FILL_RPT | [0x0001] stretch the edges of the image to fill exposed areas. | |
FILL_NOCHANGE | [0x0002] do not change exposed areas. |
uDlgFlags | User interface flags for this dialog, which determines the layout and action of the dialog. Possible values are: | |
Value | Meaning | |
DLG_ZOOMWAVE_SHOW_CONTEXTHELP | [0x00000002] dialog should contain a context sensitive help icon. | |
DLG_ZOOMWAVE_SHOW_APPLY | [0x00000080] Show the Apply button in the dialog. The dialog will not apply any effect unless the user presses the Apply button. | |
pfnHelpCallback | Ignored. | |
pHelpCallBackUserData | Ignored. |