引用▼
类型定义结构体_HALFTONEDLGPARAMS｛L_UINTuStructSize;pBITMAPHANDLEpBitmap;L_BOOLbZoomToFit;L_UINTuDim;L_INTnAngle;L_UINT32uType;LPDLGBITMAPLISTpBitmapList;L_UINT* puInListIndexes;L_INT32nInCount;HBITMAPLISThList;L_UINT32uDlgFlags;LPPOINT pptPosition;LTCOMMDLGHELPCBpfnHelpCallback;L_VOID* pHelpCallBackUserData;} halftonedlgparams，* lphalftonedlgparams;
的HALFTONEDLGPARAMS属性创建的对话框的初始化信息L_DlgHalftone函数。在用户关闭对话框后，有关用户选择的信息将在此结构中更新。
此结构的大小，以字节为单位。使用sizeof操作符计算该值。
指向位图句柄的指针，该句柄引用用于预览或处理的位图。
标志，指示预览图像的初始缩放级别。可能取值为:
| 价值 | 意义 |
|---|---|
| 真正的 | 将初始缩放级别设置为“缩放到适合”。 |
| 假 | 设置初始缩放级别为“正常(1:1)”。 |
值，该值指示颗粒的大小。取值范围为2 ~ 100。如果uType为HT_VIEW或HT_PRINT，则忽略此值。如果uType不是HT_VIEW或HT_PRINT, uDim应该是>= 1。
旋转的角度，用百分之一度表示取值范围为-36000 ~ 36000。值为0产生水平半色调图案。此参数指定要更改模式的度数。正值使图案顺时针旋转;负值使图案逆时针旋转。如果uType为HT_RECT, HT_CIRC, HT_RAND或HT_USERDEF，则忽略此值。
值表示半色调模式。可能取值为:
| 价值 | 意义 |
|---|---|
| HT_PRINT | [0x0000]打印用半色调 |
| HT_VIEW | [0x0001]显示半色调 |
| HT_RECT | [0x0002]矩形半色调 |
| HT_CIRC | [0x0003]圆形半色调 |
| HT_ELLIPS | [0x0004]椭圆半色调 |
| HT_RAND | [0x0005]随机半色调 |
| HT_LINEAR | [0x0006]线性半色调 |
| HT_USERDEF | [0x0007]用户自定义半色调 |
指向DLGBITMAPLIST结构，该结构包含到半色调的位图。方法之前设置此值L_DlgHalftone函数将初始化对话框中的“Available List”。DLGBITMAPLIST结构的pszDescription成员将被用来填充“Available List”字段，而DLGBITMAPLIST结构的pszFileName成员将被忽略。如果为NULL, HT_USERDEF和与此选项相关的控件将被隐藏。
位图pBitmapList数组的索引数组。(puInListIndexes[i]中的值是pBitmapList数组的索引。)当Halftone对话框第一次显示时，此列表中索引引用的位图将包含在“选定列表”中。如果你传递NULL，“选择列表”将是空的。
puInListIndexes数组中的项数。
位图列表的句柄，它将包含“选定列表”中的所有位图，如果选择HT_USERDEF选项，它将用于半色调，这个成员应该创建throwL_CreateBitmapList在调用对话框之前，销毁这个列表是用户的责任。
✎注意
如果pBitmapList值为NULL，该成员将被忽略。
此对话框的用户界面标志，它们决定对话框的布局和操作。可能取值为:
| 价值 | 意义 |
|---|---|
| DLG_HALFTONE_AUTOPROCESS | [0x00000001]处理图像OK。这个结构的pBitmap成员应该包含一个有效的位图。 |
| DLG_HALFTONE_SHOW_CONTEXTHELP | [0x00000002]对话框应该包含一个上下文敏感的帮助图标。 |
| DLG_HALFTONE_SHOW_PREVIEW | [0x00000004]在对话框中显示图像预览。这个结构的pBitmap成员应该包含一个有效的位图。 |
| DLG_HALFTONE_SHOW_TOOL_ZOOMLEVEL | [0x00000008]显示“缩放到适合”和“缩放正常”工具栏按钮。为了显示这些按钮，必须设置DLG_HALFTONE_SHOW_PREVIEW标志。 |
指向可选帮助回调函数的指针。如果您不希望为该对话框提供帮助，请使用NULL作为该参数的值。要为这个对话框提供帮助，请使用函数指针作为该参数的值。回调函数必须遵循中描述的原型LTCOMMDLGHELPCB．
可用于传递回调函数所需的一个或多个附加参数的空指针。要使用此特性，请为变量赋值或创建包含所需字段的结构。然后，在这个参数中，传递变量或结构的地址，将其强制转换为L_VOID*。回调函数在其自己的pHelpCallBackUserData参数中接收地址，可以将其转换为适当数据类型的指针以访问变量或结构。如果不需要附加参数，则可以在此参数中传递NULL。