IMathInputControl::GetHoverIcon 方法 (micaut.h)

检索要用于悬停目标以启动数学输入控件的图标。

语法

HRESULT GetHoverIcon(
  [out, retval] IPictureDisp **HoverImage
);

参数

[out, retval] HoverImage

指向悬停目标图标的指针的地址。

返回值

该方法返回 HRESULT。 可能的返回代码包括但不限于下表中的返回代码。

返回代码 说明
S_OK
方法成功。
S_FALSE
无法检索该图标。

注解

如果实现悬停目标,强烈建议应用程序使用此图标。 图标以.ico格式返回,并将匹配系统每英寸点数 (DPI) 设置。

图标作为宽度和高度固定的 32 位图像提供。 在 96 DPI 下,值为 Width = 63,Height = 49。 对于其他 DDI,这些值会相应地更改。 例如,在 144 DPI 系统上:Width = 63 * 144 / 96,Height = 49 *144 / 96。 检索悬停图标的应用程序负责释放图标资源。

示例


CComPtr <IMathInputControl> g_spMIC; // Math Input Control

BOOL TestDlg::OnInitDialog(){
    
    HRESULT hr = CoInitialize(NULL);
    hr = g_spMIC.CoCreateInstance(CLSID_MathInputControl);

    CComPtr<IPictureDisp> hoverImage;
    CComPtr<IPicture> pictureHoverImage;  

    g_spMIC->GetHoverIcon(&hoverImage); 

    hoverImage.QueryInterface(&pictureHoverImage);

    short type;
    pictureHoverImage->get_Type(&type);
    
    if (type == PICTYPE_ICON){
        OLE_HANDLE oleHandle;
        hr = pictureHoverImage->get_Handle(&oleHandle);        

        this->SetIcon((HICON)oleHandle, true);
    }    
    
    return TRUE;
}

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 micaut.h (包括 Micaut.h)

另请参阅

IMathInputControl