STITCHDLGPARAMS

typedef struct _STITCHDLGPARAMS
{
   L_UINT uStructSize; 
   pBITMAPHANDLE pResultingBitmap; 
   L_UINT uResultingBitmapStructSize; 
   L_INT nResultingBitmapWidth; 
   L_INT nResultingBitmapHeight; 
   L_INT nResultingBitmapBitsPerPixel; 
   L_INT nRes; 
   COLORREF crBackGround; 
   LPDLGBITMAPLIST pBitmapList; 
   HICON hWindowIcon; 
   L_INT nCmdShow; 
   L_UINT32 uDlgFlags; 
   LTCOMMDLGHELPCB pfnHelpCallback ; 
   L_VOID  *pHelpCallBackUserData ; 
} STITCHDLGPARAMS, * LPSTITCHDLGPARAMS ;

The STITCHDLGPARAMS structure provides information used to initialize the dialog box created by the LDialogImageEffect::DoModalStitch 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.

pResultingBitmap

Pointer to a valid bitmap handle to be updated with the bitmap resulting from the stitch dialog. If LDialogImageEffect::DoModalStitch returns SUCCESS_DLG_EXPORTANDEXIT, then this bitmap is allocated and the user is responsible for freeing this handle using LBitmapBase::Free .

uResultingBitmapStructSize

Size of the BITMAPHANDLE structure referencing pResultingBitmap.

nResultingBitmapWidth

Value that indicates the resulting image's width in pixels. This value is used to initialize the Width edit box in the Image Attributes sub dialog.

nResultingBitmapHeight

Value that indicates the resulting image's height in pixels. This value is used to initialize the Height edit box in the Image Attributes sub dialog.

nResultingBitmapBitsPerPixel

Value representing the image depth of the resulting image. This may be 1, 4, 8, 16, 24 bpp. This value is used to initialize the Depth combo box in the Image Attributes sub dialog.

nRes

Horizontal and vertical resolution, in dots per inch. This value is used to initialize the Resolution edit box in the Image Attributes sub dialog.

crBackGround

The COLORREF value that specifies the background color for the resulting image. This value is used to initialize the Back-Color color picker in the Image Attributes sub dialog.

pBitmapList

Pointer to a DLGBITMAPLIST structure that is used to initialize the image picker in the dialog. The pszDescription member of the DLGBITMAPLIST structure will be used as a tool tip for each image in the image picker when the mouse hovers over it.

hWindowIcon

Handle to the icon to use for the print window’s system menu. Pass NULL to use the default icon.

nCmdShow

Flag that indicates the display state of the stitch window. This is the same flag passed to the ShowWindow windows API function. Please refer to the Microsoft SDK documentation – Windows User Interface – ShowWindow for more information. Please note that the SW_HIDE flag is ignored.

 

uDlgFlags

User interface flags for this dialog, which determine the layout and action of the dialog. Possible values are:

 

Value

Meaning

 

DLG_STITCH_NOPAGESETUPONSTART

[0x00000001] Don’t display the image attributes sub dialog at stitch dialog startup.

pfnHelpCallback

Ignored.

pHelpCallBackUserData

Ignored.