类型定义结构体_FILECONVERSIONDLGPARAMS
{
L_UINTuStructSize;
L_UINTuOverwrite;
LPFILESAVEFORMATpFileFormats;
L_INT32nFileFormatsCount;
L_TCHARszDestPath [L_MAXPATH];
L_TCHARszAddSrcFilePath [L_MAXPATH];
L_BOOLbUseLogReport;
L_BOOLbRemoveSrcFile;
L_BOOLbShowFullPath;
L_BOOLbUseOriginalFolder;
L_TCHAR* pszSrcFileList;
L_UINT32uDlgFlags;
LTCOMMDLGHELPCBpfnHelpCallback;
L_VOID* pHelpCallBackUserData;
} fileconversiondlgparams, * lpfileconversiondlgparams;
的FILECONVERSIONDLGPARAMS属性创建的对话框的初始化信息L_DlgFileConversion函数。在用户关闭对话框后,该结构将被更新为有关用户选择的信息。
此结构的大小,以字节为单位。使用sizeof操作符计算该值。
值,该值指示在转换文件时如何处理具有相同转换后的文件名、扩展名和路径的文件的存在。可能取值为:
价值 | 意义 |
---|---|
DLG_FILECONVERSION_OVERWRITE_ASK | [0]每次都会出现一个消息框,询问如何处理该文件。它还允许您中止所有转换操作。 |
DLG_FILECONVERSION_OVERWRITE_SKIP | 跳过转换这个文件,继续到下一个文件。 |
DLG_FILECONVERSION_OVERWRITE_REPLACE | [2]使用新文件替换原有文件。 |
DLG_FILECONVERSION_OVERWRITE_RENAME | [3]给新文件一个与现有文件不同的文件名。 |
指向FILESAVEFORMAT结构数组的指针,该结构数组将指示在文件转换对话框中包括哪些格式、BPP和子格式。数组中元素的顺序表示项目将在FileType下拉列表框中出现的顺序。传递NULL使LEADTOOLS将所有支持的格式、BPP和子格式添加到文件转换对话框。有关可用文件类型的详细信息,请参见自定义文件格式列表.
pFileFormats中的项数。如果pFileFormats为NULL,则忽略该成员。有关可用文件类型的详细信息,请参见自定义文件格式列表.
字符串,包含保存已转换文件的文件夹的路径。
字符串,包含要转换的文件所在文件夹的路径。
转换操作完成后是否查看日志报表的标志。可能取值为:
价值 | 意义 |
---|---|
真正的 | 转换完成后显示日志报表。 |
假 | 转换完成后请勿显示日志报表。 |
标志,指示转换操作完成后是否删除源文件。可能取值为:
价值 | 意义 |
---|---|
真正的 | 在转换过程完成后删除源文件。 |
假 | 不要在转换过程完成后删除源文件。 |
标志,指示是在源文件列表中查看文件名和路径,还是仅查看文件名。可能取值为:
价值 | 意义 |
---|---|
真正的 | 在源文件列表中显示文件名和路径。 |
假 | 在源文件列表中只显示文件名。 |
标志,指示是否将转换后的文件保存在与源文件相同的文件夹中。可能取值为:
价值 | 意义 |
---|---|
真正的 | 将转换后的文件保存在与源文件相同的文件夹中。 |
假 | 不要将转换后的文件保存在与源文件相同的文件夹中。 |
指向一个缓冲区的指针,该缓冲区包含“源文件”列表中每个文件的目录名和文件名。目录和文件名字符串由NULL分隔,最后一个文件名后面有一个额外的NULL字符。例如:“C:\images\\0MyFile.cmp\0MyFile2.cmp\0MyOtherFile.cmp\0MyLastFile.cmp\0\0”。
✎注意
所有文件必须在同一个文件夹中。
此对话框的用户界面标志,它们决定对话框的布局和操作。可能取值为:
价值 | 意义 |
---|---|
DLG_FILECONVERSION_SHOW_CONTEXTHELP | [0x00000001]对话框应该包含一个上下文敏感的帮助图标。 |
DLG_FILECONVERSION_SHOW_PREVIEW | [0x00000002]在源文件列表中显示所选映像的预览。 |
DLG_FILECONVERSION_SHOW_LOADOPTIONS | [0x00000004]对话框应该有一个“选项”按钮。 |
DLG_FILECONVERSION_SHOW_FILEINFO | [0x00000008]对话框应该有一个“文件信息”按钮。 |
DLG_FILECONVERSION_SHOW_PREVIEW_PAGES | [0x00000010]对话框应该有![]() ![]() |
DLG_FILECONVERSION_SHOW_RESIZE | [0x00000020]对话框应该有一个“调整大小”按钮。 |
DLG_FILECONVERSION_SHOW_ROTATE | [0x00000040]对话框应该有一个“旋转”按钮。 |
DLG_FILECONVERSION_SHOW_NAMINGTEMPLATE | [0x00000080]对话框应该有一个“命名模板”按钮。 |
DLG_FILECONVERSION_SHOW_OVERWRITE | [0x00000100]对话框应该有“覆盖”组合。 |
DLG_FILECONVERSION_SHOW_OVERWRITE_ASK | [0x00000200]对话框的“覆盖”组合中应该有“询问”选项。 |
DLG_FILECONVERSION_SHOW_OVERWRITE_SKIP | [0x00000400]对话框的“覆盖”组合中应该有“跳过”选项。 |
DLG_FILECONVERSION_SHOW_OVERWRITE_REPLACE | [0x00000800]对话框的“覆盖”组合中应该有“替换”选项。 |
DLG_FILECONVERSION_SHOW_OVERWRITE_RENAME | [0x00001000]对话框的“覆盖”组合中应该有“重命名”选项。 |
DLG_FILECONVERSION_SHOW_OVERWRITE_ALL | [0x00001E00]对话框的“覆盖”组合中应该有所有的覆盖选项。 |
DLG_FILECONVERSION_SHOW_ADD | [0x00002000]对话框应该有“添加”![]() |
DLG_FILECONVERSION_SHOW_ADDFOLDER | [0x00004000]对话框应该有一个“添加文件夹”按钮![]() |
DLG_FILECONVERSION_SHOW_REMOVE | [0x00008000]对话框应该有一个“移除”按钮![]() |
DLG_FILECONVERSION_SHOW_SELECTALL | [0x00010000]对话框应该有一个“全选”按钮![]() |
DLG_FILECONVERSION_SHOW_DELETEORIGINAL | [0x00020000]对话框的“源文件”组中应该有“删除/覆盖文件”复选框。 |
DLG_FILECONVERSION_SHOW_NEWFORMATSUPDATES | [0x00040000]对话框应该有版本15的新格式更新。 |
DLG_FILECONVERSION_ENABLE_SAVE_LOG | [0x00080000]在报告对话框中显示保存日志按钮,并启用保存转换报告到日志文件。 |
指向可选帮助回调函数的指针。如果您不希望为该对话框提供帮助,请使用NULL作为该参数的值。要为这个对话框提供帮助,请使用函数指针作为该参数的值。回调函数必须遵循中描述的原型LTCOMMDLGHELPCB.
可用于传递回调函数所需的一个或多个附加参数的空指针。要使用此特性,请为变量赋值或创建包含所需字段的结构。然后,在这个参数中,传递变量或结构的地址,将其强制转换为L_VOID*。回调函数在其自己的pHelpCallBackUserData参数中接收地址,可以将其转换为适当数据类型的指针以访问变量或结构。如果不需要附加参数,则可以在此参数中传递NULL。