IMathInputControl::GetHoverIcon-Methode (micaut.h)

Ruft das Symbol ab, das für das Hoverziel zum Starten des mathematischen Eingabesteuerelements verwendet werden soll.

Syntax

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

Parameter

[out, retval] HoverImage

Die Adresse des Zeigers auf das Hoverzielsymbol.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Rückgabecodes sind u. a. die In der folgenden Tabelle.

Hinweise

Anwendungen wird dringend empfohlen, dieses Symbol bei der Implementierung eines Hoverziels zu verwenden. Das Symbol wird in .ico Format zurückgegeben und entspricht der Dpi-Einstellung (Dots per Inch).

Das Symbol wird als 32-Bit-Bild mit fester Breite und Höhe bereitgestellt. Bei 96 DPI sind die Werte Breite = 63, Höhe = 49. Bei anderen DPIs werden diese Werte entsprechend geändert. Beispielsweise auf einem 144 DPI-System: Breite = 63 * 144 / 96 und Höhe = 49 * 144 / 96. Die Anwendung, die das Hoversymbol abruft, ist für die Freigabe der Symbolressourcen verantwortlich.

Beispiele

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;
}

Anforderungen

Weitere Informationen

IMathInputControl