Partilhar via


CMFCButton::SetImage

Define a imagem de um botão.

void SetImage(
   HICON hIcon,
   BOOL bAutoDestroy=TRUE,
   HICON hIconHot=NULL,
   HICON hIconDisabled=NULL,
   BOOL bAlphaBlend=FALSE 
);
void SetImage(
   HBITMAP hBitmap,
   BOOL bAutoDestroy=TRUE,
   HBITMAP hBitmapHot=NULL,
   BOOL bMap3dColors=TRUE,
   HBITMAP hBitmapDisabled=NULL 
);
void SetImage(
   UINT uiBmpResId,
   UINT uiBmpHotResId=0,
   UINT uiBmpDsblResID=0 
);

Parâmetros

  • [in] hIcon
    Identificador para o ícone que contém o bitmap e a máscara para a nova imagem.

  • [in] bAutoDestroy
    TRUE para especificar que os recursos de bitmap são automaticamente; destruídos caso contrário, FALSE.O padrão é TRUE.

  • [in] hIconHot
    Identificador para o ícone que contém a imagem para o estado selecionado.

  • [in] hBitmap
    Identificador para o bitmap que contém a imagem para o estado não selecionado.

  • [in] hBitmapHot
    Identificador para o bitmap que contém a imagem para o estado selecionado.

  • [in] uiBmpResId
    Identificação de recurso para a imagem não selecionada.

  • [in] uiBmpHotResId
    Identificação de recurso para a imagem selecionada.

  • [in] bMap3dColors
    Especifica uma cor transparente para o plano de fundo do botão; ou seja, a face do botão.TRUE para usar o valor de cor RGB (192, 192, 192); FALSE para usar o valor de cor definido por AFX_GLOBAL_DATA::clrBtnFace.

  • [in] hIconDisabled
    Identificador para o ícone para a imagem desativado.

  • [in] hBitmapDisabled
    Identificador para o bitmap que contém a imagem desativado.

  • [in] uiBmpDsblResID
    Identificação do recurso de bitmap desativado.

  • [in] bAlphaBlend
    TRUE para usar somente as imagens de 32 bits que usam o canal alfa; FALSE, para não usar somente o canal alfa imagens.O padrão é FALSE.

Exemplo

O exemplo seguinte demonstra como usar várias versões do método de SetImage na classe de CMFCButton .o exemplo é parte de novo exemplo de controles.

    CMFCButton m_Button;


...


    // int m_iImage
    // IDB_BTN1_32, IDB_BTN1_HOT_32, IDB_BTN1, IDB_BTN1_HOT are int macros that are #define.
    if (m_iImage == 1) 
    {
        m_Button.SetImage((HBITMAP) NULL);
    }
    else
    {
        m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
    }

Requisitos

Cabeçalho: afxbutton.h

Consulte também

Referência

Classe de CMFCButton

Gráfico de hierarquia