Partilhar via


CMFCButton::SetImage

Configura 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 uma máscara para a nova imagem.

  • [in] bAutoDestroy
    TRUE Para especificar que recursos de bitmap ser destruído automaticamente; 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
    ID de recurso para a imagem não selecionados.

  • [in] uiBmpHotResId
    ID de recurso para a imagem selecionada.

  • [in] bMap3dColors
    Especifica uma cor transparente para o botão de plano de fundo, 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 pela AFX_GLOBAL_DATA::clrBtnFace.

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

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

  • [in] uiBmpDsblResID
    ID de recurso do bitmap desabilitado.

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

Exemplo

O exemplo a seguir demonstra como usar várias versões do SetImage método na CMFCButton classe. O exemplo faz parte o Exemplo do NewControls: Aplicativo de demonstração de controles MFC.

    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
    {
        if (afxGlobalData.bIsOSAlphaBlendingSupport)
        {
            m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
        }
        else
        {
            m_Button.SetImage(IDB_BTN1, IDB_BTN1_HOT);
        }
    }

Requisitos

Cabeçalho: afxbutton.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMFCButton