Metodo IMathInputControl::GetHoverIcon (micaut.h)

Articolo
02/29/2024

Recupera l'icona da usare per la destinazione del puntatore del mouse per avviare il controllo di input matematico.

Sintassi

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

Parametri

[out, retval] HoverImage

Indirizzo del puntatore all'icona di destinazione del mouse.

Valore restituito

Il metodo restituisce un HRESULT. I codici restituiti possibili includono, ma non sono limitati a quelli della tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
S_FALSE	Impossibile recuperare l'icona.

Commenti

Le applicazioni sono fortemente incoraggiate a usare questa icona se si implementa una destinazione del passaggio del mouse. L'icona viene restituita in .ico formato e corrisponderà all'impostazione dei punti di sistema per pollice (DPI).

L'icona viene fornita come immagine a 32 bit con larghezza fissa e altezza. A 96 DPI, i valori sono Width = 63, Height = 49. Per altri dati dpi questi valori vengono modificati di conseguenza. Ad esempio, in un sistema 144 DPI: Width = 63 * 144 / 96 e Height = 49 *144 /96. L'applicazione che recupera l'icona del puntatore del mouse è responsabile del rilascio delle risorse dell'icona.

Esempio


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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	micaut.h (include Micaut.h)

Vedi anche

IMathInputControl

Condividi tramite