《Windows API巡礼》のGetDlgItem*函数

1）函数GetDlgItem用来获取指定对话框中控件的句柄：

HWND WINAPI GetDlgItem(

  __in_opt  HWND hDlg, //包含控件的对话框的句柄

  __in      int nIDDlgItem //要获取的控件的ID

);

函数调用成功返回指定控件的句柄，失败时返回NULL，表示无效的对话框或不存在的控件。

 

2）函数GetDlgItemText用来获取对话框中控件的标题(title)或文本(text)信息的：

UINT WINAPI GetDlgItemText(

  __in   HWND hDlg, //包含控件的对话框句柄

  __in   int nIDDlgItem, //要获取信息的控件的ID

  __out  LPTSTR lpString, //存放获取到的信息的缓冲区

  __in   int nMaxCount //要复制到lpString的字符最大个数，超出则截断

);

 

函数调用成功返回复制到缓冲区的字符个数（不包括null结束符）；失败时返回0，可调用GetLastError查看详细错误信息。

GetDlgItemText函数的调用会向指定的控件发送一个WM_GETTEXT消息。

 

3）函数SetDlgItemText用来给对话框中的控件设置标题或显示文本信息：

BOOL WINAPI SetDlgItemText(

  __in  HWND hDlg, //包含控件的对话框句柄

  __in  int nIDDlgItem, //要设置信息的控件的ID

  __in  LPCTSTR lpString //要复制到控件的信息

);

函数调用成功返回非零值，失败返回零值；可调用GetLastError()咯。

SetDlgItemText函数的调用会向指定的控件发送一个WM_SETTEXT消息。

 

4）函数GetDlgItemInt用来将指定对话框中某控件的文本值转换为整型值：

UINT WINAPI GetDlgItemInt(

  __in       HWND hDlg, //包含控件的对话框句柄

  __in       int nIDDlgItem, //要转换文本的控件ID

  __out_opt  BOOL *lpTranslated, //表示函数调用成功或失败，TRUE—成功；FALSE---失败；

//为NULL时表示不返回成功与否信息

  __in       BOOL bSigned //TRUE---表示函数检查文本开头是否存在负号，如果是就返回一个

//有符号整型值；FALSE---函数返回无符号整型值

);

函数调用成功时，参数lpTranslated被设置为TRUE，返回值是控件文本转换后的值；函数调用失败时，参数lpTranslated被置为FALSE，返回值是0（当然要注意：当控件文本是0时，返回值也是0）。

该函数获得指定控件文本值是通过发送WM_GETTEXT消息给控件来实现的。

 

5）函数SetDlgItemInt用来设置对话框中指定控件的文本值，该值是用字符串表示的某整型值：

BOOL WINAPI SetDlgItemInt(

  __in  HWND hDlg, //包含控件的对话框句柄

  __in  int nIDDlgItem, //控件的ID

  __in  UINT uValue, //产生控件文本值的整数值

  __in  BOOL bSigned //TRUE---uValue是有符号整数；FALSE---uValue是无符号整数

);

函数调用成功时，返回非零值；失败时返回零值。

当调用该函数设置一个新值时，函数会发送一个WM_SETTEXT消息给控件。