Метод IMathInputControl::GetHoverIcon (micaut.h)

Статья
02/29/2024

Извлекает значок, который будет использоваться для целевого объекта при наведении на запуск элемента управления математическим вводом.

Синтаксис

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

Параметры

[out, retval] HoverImage

Адрес указателя на значок целевого объекта при наведении указателя мыши.

Возвращаемое значение

Метод возвращает HRESULT. Возможные коды возврата включают, помимо прочего, коды, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Не удалось получить значок.

Приложениям настоятельно рекомендуется использовать этот значок при реализации целевого объекта наведение указателя мыши. Значок возвращается в .ico формате и будет соответствовать системным параметрам точек на дюйм (DPI).

Значок предоставляется в виде 32-разрядного изображения с фиксированной шириной и высотой. При 96 точек на дюйм значения: Ширина = 63, Высота = 49. Для других dpis эти значения изменяются соответствующим образом. Например, в системе 144 DPI: Ширина = 63 * 144 / 96 и Высота = 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
Header	micaut.h (включая Micaut.h)

См. также раздел

IMathInputControl

Поделиться через