GetDialogSize 函数

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

GetDialogSize 函数检索资源对话框的大小。

语法

BOOL WINAPI GetDialogSize(
   int     iResourceID,
   DLGPROC pDlgProc,
   LPARAM  lParam,
   SIZE    *pResult
);

参数

iResourceID

对话框资源标识符。

pDlgProc

指向对话框过程的指针。

lParam

在创建临时对话框后，WM_INITDIALOG消息中传递的值。

pResult

指向接收对话框尺寸（以屏幕像素为单位）的 SIZE 结构的指针。

返回值

如果找到对话框资源，则返回 TRUE ;否则返回 FALSE 。

备注

属性页可以使用此函数返回所需的实际显示大小。 大多数属性页都是对话框，因此，将对话框模板存储在资源文件中。 模板使用不直接映射到屏幕像素的对话框单位。 但是，属性页的 GetPageInfo 函数必须返回实际显示大小（以像素为单位）。 属性页可以调用 GetDialogSize 来计算显示大小。

此函数创建对话框的临时实例。 为了避免对话框在屏幕上显示，资源文件中的对话框模板不应具有 WS_VISIBLE 属性。

要求

另请参阅

属性页帮助程序函数