Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Recupera el icono que se va a usar para el destino de desplazamiento para iniciar el control de entrada matemática.
Sintaxis
HRESULT GetHoverIcon(
[out, retval] IPictureDisp **HoverImage
);
Parámetros
[out, retval] HoverImage
Dirección del puntero al icono de destino que mantiene el puntero.
Valor devuelto
El método devuelve un valor HRESULT. Entre los códigos de retorno posibles se incluyen, entre otros, los de la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
No se pudo recuperar el icono. |
Comentarios
Se recomienda encarecidamente que las aplicaciones usen este icono si implementan un destino de desplazamiento. El icono se devuelve en formato .ico y coincidirá con la configuración de puntos del sistema por pulgada (PPP).
El icono se proporciona como una imagen de 32 bits con ancho fijo y alto. A 96 PPP, los valores son Width = 63, Height = 49. En el caso de otros DPIs, estos valores se cambian en consecuencia. Por ejemplo, en un sistema de 144 PPP: Ancho = 63 * 144 / 96 y Alto = 49 *144 / 96. La aplicación que recupera el icono de desplazamiento es responsable de liberar los recursos del icono.
Ejemplos
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;
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | micaut.h (incluya Micaut.h) |