IMathInputControl::GetHoverIcon-Methode (micaut.h)

Artikel
03/04/2024

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.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
S_FALSE	Das Symbol konnte nicht abgerufen werden.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	micaut.h (schließen Sie Micaut.h ein)

Weitere Informationen

IMathInputControl

Freigeben über