描述
创建一个显示HTML的模态对话框。
C++ 语法
HRESULT ShowHTMLDialog( HWND hwndParent, IMoniker *pMk, VARIANT *pvarArgIn, WCHAR *pchOptions, VARIANT *pvarArgOut ); |
PowerBASIC 语法
FUNCTION ShowHTMLDialog ( _ BYVAL hwndParent AS DWORD, _ BYVAL pMk AS IUnknown, _ BYREF pvarArgIn AS VARIANT, _ BYREF pchOptions AS WSTRINGZ, _ BYREF pvarArgOut AS VARIANT _ ) AS LONG |
参数
hwndParent |
处理对话框的父级。 |
pMk |
IMoniker接口的地址，从该对话框的HTML加载。 |
pvarArgIn |
包含对话框输入数据的VARIANT的地址。此VARIANT中传递的数据将放置在窗口对象的IHTMLDialog.dialogArguments属性中。此参数可以为NULL。 |
pchOptions |
对话框的窗饰。该参数可以是NULL或包含值组合的字符串的地址，每个值用分号（;）分隔。dialogHeight:sHeight 设置对话窗口的高度（请参阅默认计量单位的注释）。 dialogLeft:sXPos 设置对话窗口相对于桌面左上角的左侧位置。 dialogTop:sYPos 设置对话窗口相对于桌面左上角的顶部位置。 dialogWidth:sWidth 设置对话窗口的宽度（参见备注默认度量单位）。 center：{yes |不| 1 | 0 |在|关闭} 指定是否将对话窗口置于桌面中。默认值为yes。 对话框：{yes |没有| 1 | 0 |在|关闭} 指定打印或使用打印预览时对话窗口是否隐藏。此函数仅在从可信应用程序打开对话框时可用。默认值为no。 边缘：{凹陷|上调} 指定对话窗口的边缘样式。默认值为提高。 帮助：{yes |没有| 1 | 0 |在|关闭} 指定对话窗口是否显示上下文相关的帮助图标。默认值为yes。 可调整大小：{yes |没有| 1 | 0 |在|关闭} 指定对话窗口是否具有固定的维度。默认值为no。 滚动：{yes |没有| 1 | 0 |在|关闭} 指定对话窗口是否显示滚动条。默认值为yes。 状态：{yes |没有| 1 | 0 |在|关闭} 指定对话框窗口是否显示状态栏。不可信对话窗口的默认值为yes，对于受信任的对话框窗口则为“否”。 unadorned：{yes |没有| 1 | 0 |在|关闭} 指定对话窗口是否显示边框窗口chrome。此函数仅在从可信应用程序打开对话框时可用。默认值为no。 |
pvarArgOut |
包含对话框的输出数据的VARIANT的地址。此VARIANT接收放置在窗口对象的IHTMLDialog.returnValue属性中的数据。此参数可以为NULL。 |
返回值
如果成功返回S_OK，否则返回错误值。
例
以下示例显示了加载Mshtml.dll所需的最基本步骤，使用GetProcAddress获取ShowHTMLDialog的地址，创建一个URL标记，并调用ShowHTMLDialog.
HINSTANCE hinstMSHTML = LoadLibrary(TEXT("MSHTML.DLL"));
if (hinstMSHTML == NULL)
{
// Error loading module -- fail as securely as possible
return;
}
SHOWHTMLDIALOGFN* pfnShowHTMLDialog;
pfnShowHTMLDialog = (SHOWHTMLDIALOGFN*)GetProcAddress(hinstMSHTML,
TEXT("ShowHTMLDialog"));
if (pfnShowHTMLDialog)
{
IMoniker *pURLMoniker;
BSTR bstrURL = SysAllocString(L"http://www.example.com/dialogsource.htm");
CreateURLMoniker(NULL, bstrURL, &pURLMoniker);
if (pURLMoniker)
{
(*pfnShowHTMLDialog)(NULL, pURLMoniker, NULL, NULL, NULL);
pURLMoniker->Release();
}
SysFreeString(bstrURL);
}
FreeLibrary(hinstMSHTML);
功能信息
库存实施 |
acredir.dll |
自定义实现 |
No |
头 |
acredir.h |
进口图书馆 |
acredir.lib |
最低可用性 |
Internet Explorer 7中 |
最低操作系统 |
Windows Vista |