RADIALWAVEDLGPARAMS
typedef struct _RADIALWAVEDLGPARAMS
{
L_UINT uStructSize;
pBITMAPHANDLE pBitmap;
L_BOOL bZoomToFit;
L_UINT uAmplitude;
L_UINT uWaveLen;
L_INT nPhase;
POINT ptCenter;
COLORREF crFill;
L_UINT uRadialWaveFlags;
L_UINT32 uDlgFlags;
LTCOMMDLGHELPCB pfnHelpCallback;
L_VOID *pHelpCallBackUserData;
} RADIALWAVEDLGPARAMS, * LPRADIALWAVEDLGPARAMS ;
The RADIALWAVEDLGPARAMS structure provides information used to initialize the dialog box created by the LDialogImageEffect::DoModalRadialWave 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. |
|
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 |
Magnitude of the wave. Valid values range from 0 to 100. |
|
uWaveLen |
Value that represents the wave length, if DIS_PER is set in the uRadialWaveFlags member. If DIS_FRQ is set in uRadialWaveFlags, this value is the number of repeated waves. Possible values range from 0 – 100. |
|
nPhase |
Wave phase shift, in hundredths of degrees. The valid range is from –36000 to 36000 (The value in degrees is nPhase divided by 100). |
|
ptCenter |
POINT structure that contains the point from which the wave radiates. 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 for any exposed areas. 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. |
|
uRadialWaveFlags |
Flags that indicate how to handle exposed areas and what type of information is in the uWaveLen parameter. You can use a bitwise OR (|) to specify one flag from each group. The following are the flags that indicate how to handle exposed areas: |
|
|
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_NOCHG |
[0x0002] do not change or process exposed areas. |
|
The following are the flags that indicate the type of information in the uWaveLen member: |
|
|
Value |
Meaning |
|
DIS_PER |
[0x0000] The value in uWaveLen is a wavelength given as a percent of the bitmap dimensions. If this value is set, the valid range of uWaveLen is from 0 to 100. |
|
DIS_FRQ |
[0x0010] The value in uWaveLen is the frequency, or the number of times the wave repeats. |
uDlgFlags |
User interface flags for this dialog, which determine the layout and action of the dialog. Possible values are: |
|
|
Value |
Meaning |
|
DLG_RADIALWAVE_SHOW_CONTEXTHELP |
[0x00000002] dialog should contain a context sensitive help icon. |
|
DLG_RADIALWAVE_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. |