《Windows核心编程》の“查找”和“替换”对话框+“页面设置”对话框

要显示“查找”和“替换”文本对话框分别使用函数FindText和ReplaceText：

HWND WINAPI FindText(

  __in  LPFINDREPLACE lpfr

);

HWND WINAPI ReplaceText(

  __inout  LPFINDREPLACE lpfr

);

这两个函数都使用同样的FINDREPLACE结构：

typedef struct {

  DWORD        lStructSize; //结构长度

  HWND         hwndOwner; //所属窗口

  HINSTANCE    hInstance; //

  DWORD        Flags; //标志

  LPTSTR       lpstrFindWhat; //指向包含查找字符串的指针，缓冲区的长度至少是80字节，这个字符

                   //串在初始化时出现在“查找内容”编辑框中，函数也在这里返回用户输入的内容

  LPTSTR       lpstrReplaceWith; //指向包含替换字符串的指针，本字符串在初始化时出线在

//“替换为”编辑框中，函数也在这里返回用户输入的内容，这个字段在FindText时可以

//为NULL，但在使用ReplaceText时必须设置，否则对话框不会显示

  WORD         wFindWhatLen; //查找字符串缓冲区长度

  WORD         wReplaceWithLen; //替换字符串缓冲区长度

  LPARAM       lCustData; //

  LPFRHOOKPROC lpfnHook; //

  LPCTSTR      lpTemplateName; //

} FINDREPLACE, *LPFINDREPLACE;

 

结构中关键字段说明：

Flags---标志，创建对话框时函数根据标志中的数值初始化对话框中各控件的状态，返回时根据用户的选择来设置标志字段的内容，标志字段是以下值的组合：

FR_FINDNEXT, FR_REPLACE, FR_REPLACEALL, FR_DIALOGTERM     //分别表示用户单击了

//“查找下一个”、“替换”、“全部替换”、“取消”按钮

FR_HIDEUPDOWN, FR_HIDEMATCHCASE, FR_HIDEWHOLEWORD //初始化时使用，表示对话框中

                            //不显示“方向”、“区分大小写”、“全字匹配”按钮

FR_NOMATCHCASE, FR_NOUPDOWN, FR_NOWHOLEWORD //初始化时将“区分大小写”、

                            //“方向”、“全字匹配”按钮灰化

FR_MATCHCASE, FR_WHOLEWORD       //表示用户选择了“区分大小写”或“全字匹配”复选框

FR_DOWN     //把“方向”单选钮设置为“向下”

 

“查找”和“替换”对话框的使用有些特殊，因为这两种对话框是非模态对话框，即FildText和ReplaceText函数被调用后，系统显示对话框马上返回，对话框保持显示状态，直到用户按下了“取消”按钮后对话框才关闭。

如果用户按下了对话框中的某个按钮，对话框设置FINDREPLACE结构中相关字段并通过自定义消息通知父窗口的窗口过程，程序中处理查找和替换的功能集中在这个自定义消息中完成。另外，由于对话框必须向父窗口发送消息，所以hwndOwner字段中必须指定父窗口的句柄，而不能像其他通用对话框一样可以把hwndOwner设置为NULL。

 

为了让对话框能够使用自定义消息，程序必须首先使用RegisterWindowMessage函数注册自定义消息，这个函数注册消息并返回消息ID，输入参数是消息名称字符串：

UINT WINAPI RegisterWindowMessage(

  __in  LPCTSTR lpString

);

Windows编程手册中说明了要为查找和替换对话框注册FINDMSGSTRING消息：

#define FINDMSGSTRING TEXT("commdlg_FindReplace")

 

注意，要把RegisterWindowMessage函数返回的消息ID保存下来，并在主窗口的消息循环中通过判断uMsg是否等于这个消息ID来判断对话框是否返回消息。

因为查找和替换对话框都是非模态对话框，所以使用时要把FINDREPLACE结构和字符串变量放在全局变量中，如果放在窗口过程的局部变量中，对话框还没有关闭的情况下，这些局部变量就已经被释放，以后对话框存取的就会是无效的地址。

 

函数实例代码片段如下：

//第一步：取得FINDMSGSTRING的消息ID

UINT uFindReplaceMsg;  // message identifier for FINDMSGSTRING

uFindReplaceMsg = RegisterWindowMessage(FINDMSGSTRING);

…..

//第二步：显示对话框

FINDREPLACE fr;       // common dialog box structure

HWND hwnd;            // owner window

CHAR szFindWhat[80];  // buffer receiving string

HWND hdlg = NULL;     // handle to Find dialog box

 

// Initialize FINDREPLACE

ZeroMemory(&fr, sizeof(fr));

fr.lStructSize = sizeof(fr);

fr.hwndOwner = hwnd;

fr.lpstrFindWhat = szFindWhat;

fr.wFindWhatLen = 80;

fr.Flags = 0;

 

hdlg = FindText(&fr);

….

//第三步：处理对话框返回的自定义消息

LPFINDREPLACE lpfr;

 

if (message == uFindReplaceMsg)

{

    // Get pointer to FINDREPLACE structure from lParam.

    lpfr = (LPFINDREPLACE)lParam;

 

    // If the FR_DIALOGTERM flag is set,

    // invalidate the handle that identifies the dialog box.

    if (lpfr->Flags & FR_DIALOGTERM)

    {

        hdlg = NULL;

        return 0;

    }

 

    // If the FR_FINDNEXT flag is set,

    // call the application-defined search routine

    // to search for the requested string.

    if (lpfr->Flags & FR_FINDNEXT)

    {

        SearchFile(lpfr->lpstrFindWhat,

                   (BOOL) (lpfr->Flags & FR_DOWN),

                   (BOOL) (lpfr->Flags & FR_MATCHCASE));

    }

 

    return 0;

}

 

=======================================================

“页面设置”对话框用来设置打印机参数，用户可以在对话框中选择打印机、打印机纸张大小、页边距和纸张方向，还可以引出一个打印机属性的设置对话框。

显示“页面设置”对话框使用PageSetupDlg函数：

BOOL WINAPI PageSetupDlg(

  __inout  LPPAGESETUPDLG lppsd

);

lppsd参数指向一个PAGESETUPDLG参数：

typedef struct tagPSD {

  DWORD           lStructSize; //结构长度

  HWND            hwndOwner; //所属窗口

  HGLOBAL         hDevMode; //指向DEVMODE结构

  HGLOBAL         hDevNames; //指向DEVNAME结构

  DWORD           Flags; //标志

  POINT           ptPaperSize; //一个POINT结构，返回纸张大小

  RECT            rtMinMargin; //返回最小允许的页边距

  RECT            rtMargin; //返回用户选择的页边距

  HINSTANCE       hInstance; //

  LPARAM          lCustData; //

  LPPAGESETUPHOOK lpfnPageSetupHook; //

  LPPAGEPAINTHOOK lpfnPagePaintHook; //

  LPCTSTR         lpPageSetupTemplateName; //

  HGLOBAL         hPageSetupTemplate; //

} PAGESETUPDLG, *LPPAGESETUPDLG;

 

结构中有关字段说明：

hDevMode---如果用户选择了打印机，那么这里返回一个指针，指向包含DEVMODE结构的内存地址，DEVMODE结构中包含了打印机的名称；

 

hDevNames---如果用户选择了打印机，那么这里返回一个指针，指向包含DEVNAMES结构的内存地址，DEVNAMES结构包含了打印机的各种属性；

 

Flags---标志，以下值的组合：

PSD_DEFAULTMINMARGINS     //将页边距设置为打印机允许的最小页边距

PSD_DISABLEMARGINS        //灰化页边距设置输入框

PSD_DISABLEORIENTATION      //灰化纸张方向选择框

PSD_DISABLEPAPER      //灰化纸张方向选择框

PSD_DISABLEPAGEPAINTING     //不绘画最上方的打印示例图示

PSD_DISABLEPRINTER //灰化“打印机”按钮

PSD_MARGINS      //函数用rtMargin字段的值初始化对话框中的数值

PSD_RETURNDEFAULT        //函数不显示对话框，马上返回并在hDevNames和hDevMode字段中返回

                                     //默认打印机的设置情况

PSD_INTHOUSANDTHSOFINCHES//指明ptPagerSize、rtMinMargin和rtMargin等字段使用的单位是英寸

PSD_INHUNDREDTHSOFMILLIMETERS //指明ptPagerSize、rtMinMargin和rtMargin等字段

//使用的单位是毫米