Compartilhar via

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

  • Artigo

Recupera o ícone a ser usado para o destino de foco para iniciar o controle de entrada matemática.

Sintaxe

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

Parâmetros

[out, retval] HoverImage

O endereço do ponteiro para o ícone de destino de foco.

Retornar valor

O método retorna um HRESULT. Os códigos de retorno possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
S_FALSE
 Não foi possível recuperar o ícone.

Comentários

Os aplicativos são altamente incentivados a usar esse ícone se implementarem um destino de foco. O ícone é retornado no formato .ico e corresponderá à configuração de DPI (pontos por polegada) do sistema.

O ícone é fornecido como uma imagem de 32 bits com largura e altura fixas. Em 96 DPI, os valores são Width = 63, Height = 49. Para outros DPIs, esses valores são alterados adequadamente. Por exemplo, em um sistema de 144 DPI: Width = 63 * 144 / 96 e Height = 49 *144 / 96. O aplicativo que recupera o ícone de foco é responsável por liberar os recursos de ícone.

Exemplos


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 Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho micaut.h (inclua Micaut.h)

Confira também

IMathInputControl