Méthode IMathInputControl ::GetHoverIcon (micaut.h)

Article
03/04/2024

Récupère l’icône à utiliser pour la cible de pointage pour lancer le contrôle d’entrée mathématique.

Syntaxe

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

Paramètres

[out, retval] HoverImage

Adresse du pointeur vers l’icône cible de pointage.

Valeur retournée

Cette méthode retourne un code HRESULT. Les codes de retour possibles incluent, sans s’y limiter, ceux du tableau suivant.

Code de retour	Description
S_OK	S_OK
S_FALSE	L’icône n’a pas pu être récupérée.

Remarques

Les applications sont vivement encouragées à utiliser cette icône si elles implémentent une cible de pointage. L’icône est retournée au format .ico et correspond au paramètre points système par pouce (PPP).

L’icône est fournie sous forme d’image 32 bits avec une largeur et une hauteur fixes. À 96 PPP, les valeurs sont Width = 63, Height = 49. Pour les autres DPI, ces valeurs sont modifiées en conséquence. Par exemple, sur un système 144 DPI : Width = 63 * 144 / 96 et Height = 49 *144 / 96. L’application qui récupère l’icône de pointage est chargée de libérer les ressources d’icône.

Exemples


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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	micaut.h (inclure Micaut.h)

Voir aussi

IMathInputControl

Partager via