Classe CMFCToolBarImages

Artigo
08/04/2024

As imagens em uma barra de ferramentas. A classe CMFCToolBarImages gerencia imagens da barra de ferramentas carregadas de recursos do aplicativo ou de arquivos. Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CMFCToolBarImages : public CObject

Membros

Construtores públicos

Nome	Descrição
CMFCToolBarImages::CMFCToolBarImages	Constrói um objeto `CMFCToolBarImages`.

Métodos públicos

Nome	Descrição
CMFCToolBarImages::AdaptColors
CMFCToolBarImages::AddIcon	Adiciona um ícone às imagens da barra de ferramentas.
CMFCToolBarImages::AddImage	Adiciona um bitmap às imagens da barra de ferramentas.
CMFCToolBarImages::CleanUp
CMFCToolBarImages::Clear	Libera os recursos do sistema que foram alocados para esse objeto.
CMFCToolBarImages::ConvertTo32Bits	Converte bitmaps sublinhados em imagens de 32 bpp.
CMFCToolBarImages::CopyImageToClipboard
CMFCToolBarImages::CopyTo
CMFCToolBarImages::CreateFromImageList	Inicializa as imagens da barra de ferramentas de uma lista de imagens (Classe CImageList).
CMFCToolBarImages::CreateRegionFromImage
CMFCToolBarImages::DeleteImage	Excluirá a imagem que tem um índice especificado das imagens da barra de ferramentas se esse conjunto de imagens da barra de ferramentas contiver imagens definidas pelo usuário.
CMFCToolBarImages::Draw	Desenha uma só imagem da barra de ferramentas (botão).
CMFCToolBarImages::DrawEx
CMFCToolBarImages::EnableRTL
CMFCToolBarImages::EndDrawImage	Libera recursos do sistema depois que uma imagem da barra de ferramentas é desenhada.
CMFCToolBarImages::ExtractIcon	Retorna o ícone que tem um índice de imagem especificado das imagens da barra de ferramentas.
CMFCToolBarImages::FillDitheredRect	Preenche um retângulo usando um pincel que tem as cores da tela de fundo da barra de ferramentas.
CMFCToolBarImages::GetAlwaysLight
CMFCToolBarImages::GetBitsPerPixel	Retorna a resolução atual de imagens sublinhadas.
CMFCToolBarImages::GetCount	Retorna o número de imagens na barra de ferramentas.
CMFCToolBarImages::GetDisabledImageAlpha	Retorna o valor do canal alfa usado para imagens desabilitadas.
CMFCToolBarImages::GetFadedImageAlpha
CMFCToolBarImages::GetImageSize	Recupera o tamanho das imagens da barra de ferramentas armazenadas na memória (tamanho da origem) ou o tamanho das imagens da barra de ferramentas desenhadas na tela (tamanho do destino).
CMFCToolBarImages::GetImageWell	Retorna o identificador para o bitmap que contém todas as imagens da barra de ferramentas.
CMFCToolBarImages::GetImageWellLight
CMFCToolBarImages::GetLastImageRect
CMFCToolBarImages::GetLightPercentage
CMFCToolBarImages::GetMapTo3DColors
CMFCToolBarImages::GetMask
CMFCToolBarImages::GetResourceOffset	Retorna o índice de imagem para uma ID de recurso especificada.
CMFCToolBarImages::GetScale	Retorna a taxa de escala atual de imagens sublinhadas.
CMFCToolBarImages::GetTransparentColor
CMFCToolBarImages::GrayImages	Torna cinza as imagens da barra de ferramentas para fazê-las parecer desabilitadas.
CMFCToolBarImages::Is32BitTransparencySupported	Determina se o sistema operacional dá suporte à combinação alfa de 32 bits.
CMFCToolBarImages::IsPreMultiplyAutoCheck
CMFCToolBarImages::IsRTL	Determina se o suporte à RTL (direita para a esquerda) está habilitado.
CMFCToolBarImages::IsReadOnly	Determina se as imagens da barra de ferramentas são somente leitura.
CMFCToolBarImages::IsScaled	Informa se as imagens sublinhadas são dimensionadas ou não.
CMFCToolBarImages::IsUserImagesList	Determina se esse conjunto de imagens da barra de ferramentas contém imagens definidas pelo usuário.
CMFCToolBarImages::IsValid	Determina se esse conjunto de imagens da barra de ferramentas contém uma imagem válida da barra de ferramentas.
CMFCToolBarImages::Load	Carrega imagens da barra de ferramentas de recursos do sistema ou de um arquivo.
CMFCToolBarImages::LoadStr
CMFCToolBarImages::MapFromSysColor
CMFCToolBarImages::MapTo3dColors
CMFCToolBarImages::MapToSysColor
CMFCToolBarImages::MapToSysColorAlpha
CMFCToolBarImages::Mirror	Espelha horizontalmente todas as imagens da barra de ferramentas.
CMFCToolBarImages::MirrorBitmap	Espelha horizontalmente um bitmap.
CMFCToolBarImages::MirrorBitmapVert
CMFCToolBarImages::MirrorVert
CMFCToolBarImages::OnSysColorChange
CMFCToolBarImages::PrepareDrawImage	Aloca os recursos necessários para desenhar uma imagem da barra de ferramentas em um tamanho especificado.
CMFCToolBarImages::Save	Armazenará as imagens da barra de ferramentas em um arquivo se esse conjunto de imagens da barra de ferramentas contiver imagens definidas pelo usuário.
CMFCToolBarImages::SetAlwaysLight
CMFCToolBarImages::SetDisabledImageAlpha	Define o valor do canal alfa usado para imagens desabilitadas.
CMFCToolBarImages::SetFadedImageAlpha
CMFCToolBarImages::SetImageSize	Define o tamanho de uma imagem da barra de ferramentas (tamanho da origem).
CMFCToolBarImages::SetLightPercentage
CMFCToolBarImages::SetMapTo3DColors
CMFCToolBarImages::SetPreMultiplyAutoCheck
CMFCToolBarImages::SetSingleImage
CMFCToolBarImages::SetTransparentColor	Define a cor transparente das imagens da barra de ferramentas.
CMFCToolBarImages::SmoothResize	Redimensiona suavemente as imagens sublinhadas.
CMFCToolBarImages::UpdateImage	Atualiza uma imagem de barra de ferramentas definida pelo usuário com base em um bitmap.

Métodos protegidos

Nome	Descrição
CMFCToolBarImages::PreMultiplyAlpha

Membros de dados

Nome	Descrição
CMFCToolBarImages::m_bDisableTrueColorAlpha	TRUE se a combinação alfa truecolor (cor de 32 bits) estiver desabilitada.

Comentários

O bitmap completo das imagens da barra de ferramentas gerenciadas por CMFCToolbarImages consiste em uma ou mais pequenas imagens de barra de ferramentas (botões) de um tamanho fixo.

Exemplo

O exemplo a seguir demonstra como configurar um objeto CMFCToolBarImages usando vários métodos na classe CMFCToolBarImages. O exemplo mostra como definir o tamanho da imagem da barra de ferramentas, carregar uma imagem e definir a cor transparente da imagem. Esse snippet de código faz parte do exemplo de Demonstração do Visual Studio.

CMFCToolBarImages m_Image;

m_Image.SetImageSize(CSize(32, 32));
m_Image.Load(IDR_START);
m_Image.SetTransparentColor(RGB(255, 0, 255));

Hierarquia de herança

CObject

CMFCToolBarImages

Requisitos

Cabeçalho: afxtoolbarimages.h

CMFCToolBarImages::AdaptColors

void AdaptColors(
    COLORREF clrBase,
    COLORREF clrTone);

Parâmetros

[in] clrBase
[in] clrTone

Comentários

CMFCToolBarImages::AddIcon

Adiciona um ícone à lista de imagens da barra de ferramentas.

int AddIcon(
    HICON hIcon,
    BOOL bAlphaBlend=FALSE);

Parâmetros

hIcon
[in] Um identificador para o ícone a ser adicionado.

bAlphaBlend
[in] TRUE se esse ícone for usado com a combinação alfa; caso contrário, FALSE.

Valor de retorno

O índice baseado em zero da imagem da barra de ferramentas que foi adicionada se o método for bem-sucedido; caso contrário, -1.

CMFCToolBarImages::AddImage

Adiciona um bitmap às imagens da barra de ferramentas.

int AddImage(
    HBITMAP hbmp,
    BOOL bSetBitPerPixel=FALSE);

int AddImage(
    const CMFCToolBarImages& imageList,
    int nIndex);

Parâmetros

hbmp
[in] O identificador para o bitmap a ser adicionado.

bSetBitPerPixel
[in] TRUE se o objeto CMFCToolBarImages usa a profundidade de cor (bits por pixel) da nova imagem; FALSE se o objeto CMFCToolbarImages mantém a profundidade de cor atual.

imageList
[in] Uma referência a um objeto CMFCToolbarImages que contém a imagem a ser adicionada.

nIndex
[in] O índice no objeto CMFCToolbarImages de origem da imagem a ser adicionada.

Valor de retorno

O número de imagens da barra de ferramentas que o objeto CMFCToolBarImages mantém depois que o novo bitmap foi adicionado com êxito; -1 se a operação falhou.

CMFCToolBarImages::CleanUp

static void __stdcall CleanUp();

Comentários

CMFCToolBarImages::Clear

Libera os recursos do sistema alocados pelo objeto CMFCToolbarImages.

void Clear();

CMFCToolBarImages::CMFCToolBarImages

Constrói um objeto CMFCToolBarImages.

CMFCToolBarImages();

Comentários

Constrói um objeto CMFCToolBarImages, inicializa seu mecanismo de renderização e define o tamanho da imagem como seu valor padrão 16x15 pixels. Use CMFCToolBarImages::SetImageSize para alterar o tamanho da imagem antes de adicionar imagens.

CMFCToolBarImages::CopyImageToClipboard

BOOL CopyImageToClipboard(int iImage);

Parâmetros

[in] iImage

Valor de retorno

Comentários

CMFCToolBarImages::CopyTo

BOOL CopyTo(CMFCToolBarImages& imageList);

Parâmetros

[in] imageList

Valor de retorno

Comentários

CMFCToolBarImages::CreateFromImageList

Inicializa as imagens da barra de ferramentas de um objeto Classe CImageList.

BOOL CreateFromImageList(const CImageList& imageList);

Parâmetros

imageList
[in] A lista de imagens a ser usada como fonte para imagens da barra de ferramentas.

Valor de retorno

Sempre retorna TRUE.

Comentários

Use essa função para inicializar rapidamente a lista de imagens da barra de ferramentas de uma lista de imagens externas.

CMFCToolBarImages::CreateRegionFromImage

static HRGN __stdcall CreateRegionFromImage(
    HBITMAP bmp,
    COLORREF clrTransparent);

Parâmetros

[in] bmp
[in] clrTransparent

Valor de retorno

Comentários

CMFCToolBarImages::DeleteImage

Exclui a imagem definida pelo usuário que tem um índice especificado das imagens da barra de ferramentas.

BOOL DeleteImage(int iImage);

Parâmetros

iImage
[in] Especifica o índice baseado em zero da imagem a ser excluída.

Valor de retorno

TRUE se a imagem foi excluída com êxito; FALSE se o índice de imagem é inválido, o objeto CMFCToolbarImages é temporário, o objeto CMFCToolbarImages não contém imagens definidas pelo usuário ou se ocorreu algum outro erro.

CMFCToolBarImages::Draw

Desenha uma só imagem da barra de ferramentas.

BOOL Draw(
    CDC* pDC,
    int x,
    int y,
    int iImageIndex,
    BOOL bHilite=FALSE,
    BOOL bDisabled=FALSE,
    BOOL bIndeterminate=FALSE,
    BOOL bShadow=FALSE,
    BOOL bInactive=FALSE,
    BYTE alphaSrc=255);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

x
[in] A coordenada X do lado esquerdo do retângulo em que a imagem deve ser desenhada.

y
[in] A coordenada Y da parte superior do retângulo em que a imagem deve ser desenhada.

iImageIndex
[in] O índice baseado em zero da imagem a ser exibida.

bHilite
[in] TRUE se a imagem deve ser realçada; caso contrário, FALSE.

bDisabled
[in] TRUE se a imagem deve ser desenhada no estilo desabilitado; caso contrário, FALSE.

bIndeterminate
[in] TRUE se a imagem deve ser desenhada no estilo de estado indeterminado; caso contrário, FALSE.

bShadow
[in] TRUE se a imagem deve ser desenhada com uma sombra suspensa; caso contrário, FALSE.

bInactive
[in] TRUE se a imagem deve ser desenhada no estilo de estado inativo; caso contrário, FALSE.

alphaSrc
[in] O valor do canal alfa (opacidade). Um valor de 255 significa que a imagem é desenhada opaca. Um valor 0 significa que a imagem é desenhada transparente. Esse valor é usado apenas para imagens coloridas de 32 bits e para imagens que exibiam um estilo de vidro do Windows Vista.

Valor de retorno

TRUE se a imagem especificada foi exibida com êxito; FALSE se o índice de imagem era inválido ou ocorreu algum outro erro.

CMFCToolBarImages::DrawEx

BOOL DrawEx(
    CDC* pDC,
    CRect rect,
    int iImageIndex,
    ImageAlignHorz horzAlign = ImageAlignHorzLeft,
    ImageAlignVert vertAlign = ImageAlignVertTop,
    CRect rectSrc = CRect(0, 0, 0, 0),
    BYTE alphaSrc = 255);

Parâmetros

[in] pDC
[in] rect
[in] iImageIndex
[in] horzAlign
[in] vertAlign
[in] rectSrc
[in] alphaSrc

Valor de retorno

Comentários

CMFCToolBarImages::EnableRTL

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

Parâmetros

[in] bIsRTL

Comentários

CMFCToolBarImages::EndDrawImage

Libera recursos do sistema alocados por CMFCToolBarImages::PrepareDrawImage depois de você desenhar uma imagem da barra de ferramentas chamando CMFCToolBarImages::Draw.

void EndDrawImage(CAfxDrawState& ds);

Parâmetros

ds
[in] Uma referência ao objeto CAfxDrawState passado para o método PrepareDrawImage.

CMFCToolBarImages::ExtractIcon

Retorna o ícone que tem um índice de imagem especificado das imagens da barra de ferramentas.

HICON ExtractIcon(int nIndex);

Parâmetros

nIndex
[in] O índice baseado em zero na lista de imagens na qual a imagem a ser extraída como um ícone está localizada.

Valor de retorno

Um identificador para o ícone extraído ou NULL se nIndex estiver fora do intervalo.

CMFCToolBarImages::FillDitheredRect

Preenche um retângulo com as cores da tela de fundo da barra de ferramentas.

static void FillDitheredRect(
    CDC* pDC,
    const CRect& rect);

Parâmetros

pDC
[in] Um ponteiro para um contexto de dispositivo.

rect
[in] As coordenadas de um retângulo a ser preenchido.

Comentários

Use esse método para preencher um retângulo com uma cor que é a média das cores do sistema COLOR_BTNFACE e COLOR_BTNHIGHLIGHT. Se o sistema estiver usando 256 ou menos cores, o retângulo será preenchido com um padrão pontilhado dessas duas cores.

CMFCToolBarImages::GetAlwaysLight

BOOL GetAlwaysLight() const;

Valor de retorno

Comentários

CMFCToolBarImages::GetCount

Retorna o número de imagens na lista de imagens da barra de ferramentas.

int GetCount() const;

Valor de retorno

O número de imagens no objeto CMFCToolBarImages.

CMFCToolBarImages::GetDisabledImageAlpha

Retorna o valor do canal alfa (opacidade) usado para imagens desabilitadas.

static BYTE GetDisabledImageAlpha();

Valor de retorno

O valor atual do canal alfa.

Comentários

Você pode chamar CMFCToolBarImages::SetDisabledImageAlpha para alterar o valor do canal alfa.

CMFCToolBarImages::GetFadedImageAlpha

static BYTE __stdcall GetFadedImageAlpha();

Valor de retorno

Comentários

CMFCToolBarImages::GetImageSize

Recupera o tamanho das imagens da barra de ferramentas armazenadas na memória (tamanho da origem) ou o tamanho das imagens da barra de ferramentas desenhadas na tela (tamanho do destino).

SIZE GetImageSize(BOOL bDest=FALSE) const;

Parâmetros

bDest
[in] TRUE para recuperar o tamanho do destino; FALSE para recuperar o tamanho da imagem de origem.

Valor de retorno

Uma estrutura SIZE que especifica o tamanho de uma imagem em pixels.

Comentários

O tamanho da imagem de origem é o tamanho das imagens armazenadas no objeto CMFCToolbarImages. Você pode chamar CMFCToolBarImages::SetImageSize para definir o tamanho da origem. O valor padrão é de 16x15 pixels.

Por padrão, o tamanho da imagem de destino é 0x0. Especifique o tamanho do destino quando chamar CMFCToolBarImages::PrepareDrawImage. O método CMFCToolBarImages::EndDrawImage redefine o tamanho do destino para o valor padrão.

CMFCToolBarImages::GetImageWell

Retorna o identificador para o bitmap que contém todas as imagens da barra de ferramentas.

HBITMAP GetImageWell() const;

Valor de retorno

Um identificador para um bitmap que contém imagens da barra de ferramentas.

Comentários

As imagens da barra de ferramentas são armazenadas em uma linha em um só bitmap conhecido como um conjunto de imagens. Para localizar uma imagem da barra de ferramentas no conjunto de imagens, multiplique o índice da imagem pela largura das imagens da barra de ferramentas (confira CMFCToolBarImages::GetImageSize) para o deslocamento horizontal da imagem dentro do conjunto de imagens.

CMFCToolBarImages::GetImageWellLight

HBITMAP GetImageWellLight() const;

Valor de retorno

Comentários

CMFCToolBarImages::GetLastImageRect

CRect GetLastImageRect() const;

Valor de retorno

Comentários

CMFCToolBarImages::GetLightPercentage

int GetLightPercentage() const;

Valor de retorno

Comentários

CMFCToolBarImages::GetMapTo3DColors

BOOL GetMapTo3DColors() const;

Valor de retorno

Comentários

CMFCToolBarImages::GetMask

HBITMAP GetMask(int iImage);

Parâmetros

[in] iImage

Valor de retorno

Comentários

CMFCToolBarImages::GetResourceOffset

Retorna o índice de imagem para uma ID de recurso especificada.

int GetResourceOffset(UINT uiResId) const;

Parâmetros

uiResId
[in] Uma ID de recurso de imagem.

Valor de retorno

Um índice de imagem se o método tiver sido bem-sucedido; -1 se a imagem com a ID do recurso especificado não existir.

CMFCToolBarImages::GetTransparentColor

COLORREF GetTransparentColor() const;

Valor de retorno

Comentários

CMFCToolBarImages::GrayImages

Torna cinza as imagens da barra de ferramentas para fazê-las parecer desabilitadas.

BOOL GrayImages(int nGrayImageLuminancePercentage);

Parâmetros

nGrayImageLuminancePercentage
[in] Percentual de luminância.

Valor de retorno

TRUE se as imagens na coleção foram esmaecidas com êxito; caso contrário, FALSE.

Comentários

Esse método modifica as imagens da barra de ferramentas com uma média dos componentes vermelho, verde e azul de cada pixel e multiplicando o resultado por nGrayImageLuminancePercentage dividido por 100. Se nGrayImageLuminancePercentage for zero ou negativo, o valor padrão de 130 será usado.

Observação

Se você quiser desfazer a alteração, deverá recarregar as imagens da origem. Você pode fazer isso chamando CMFCToolBarImages::Load ou CMFCToolBarImages::UpdateImage (somente para imagens definidas pelo usuário) ou chamando CMFCToolBarImages::Clear e adicionando as imagens novamente chamando CMFCToolBarImages::AddIcon ou CMFCToolBarImages::AddImage.

CMFCToolBarImages::Is32BitTransparencySupported

Especifica se o sistema operacional dá suporte à combinação alfa de 32 bits.

static BOOL Is32BitTransparencySupported();

Valor de retorno

TRUE se houver suporte para a mesclagem alfa de 32 bits; caso contrário, FALSE.

Comentários

Use esse método estático para determinar em runtime se o sistema operacional dá suporte à combinação alfa de 32 bits. Esse recurso tem suporte no Windows 2000 e versões posteriores.

CMFCToolBarImages::IsPreMultiplyAutoCheck

BOOL IsPreMultiplyAutoCheck() const;

Valor de retorno

Comentários

CMFCToolBarImages::IsReadOnly

Especifica se as imagens da barra de ferramentas são somente leitura.

BOOL IsReadOnly() const;

Valor de retorno

TRUE se as imagens da barra de ferramentas forem somente leitura, caso contrário, FALSE.

Comentários

O objeto CMFCToolbarImages é somente leitura quando o bitmap com imagens da barra de ferramentas foi carregado de um arquivo somente leitura ou quando o bitmap foi copiado usando o método CMFCToolBarImages::CopyTemp.

CMFCToolBarImages::IsRTL

Especifica se o suporte da direita para a esquerda (RTL) está habilitado.

static BOOL IsRTL();

Valor de retorno

TRUE se o suporte a RTL estiver habilitado; caso contrário, FALSE.

Comentários

O suporte a RTL é usado quando o aplicativo é localizado em um idioma lido da direita para a esquerda, como árabe, hebraico, persa ou urdu.

CMFCToolBarImages::IsUserImagesList

Especifica se esse conjunto de imagens da barra de ferramentas contém imagens definidas pelo usuário.

BOOL IsUserImagesList() const;

Valor de retorno

TRUE se o objeto CMFCToolBarImages contiver imagens de barra de ferramentas definidas pelo usuário; caso contrário, FALSE.

CMFCToolBarImages::IsValid

Indica se esse conjunto de imagens da barra de ferramentas contém uma imagem válida da barra de ferramentas.

BOOL IsValid() const;

Valor de retorno

TRUE se um objeto CMFCToolBarImages for válido; caso contrário, FALSE.

Comentários

O objeto CMFCToolBarImages não é válido quando seu identificador para um bitmap com imagens da barra de ferramentas é NULL.

CMFCToolBarImages::Load

Carrega imagens da barra de ferramentas de recursos do sistema ou de um arquivo.

BOOL Load(
    UINT uiResID,
    HINSTANCE hinstRes=NULL,
    BOOL bAdd=FALSE);

BOOL Load(
    LPCTSTR lpszBmpFileName,
    DWORD nMaxFileSize = 819200);

Parâmetros

uiResID
[in] A ID de um recurso bitmap.

hinstRes
[in] Uma instância da DLL de recurso.

bAdd
[in] TRUE para adicionar o bitmap carregado ao bitmap existente ou FALSE para substituir o bitmap existente.

lpszBmpFileName
[in] Um caminho para um arquivo de disco do qual carregar o bitmap.

nMaxFileSize
[in] Número máximo de bytes no arquivo bitmap; ou 0 para carregar o bitmap, independentemente do tamanho do arquivo. Se o tamanho do arquivo exceder esse tamanho máximo, o método retornará FALSE e não carregará o bitmap.

Valor de retorno

TRUE se o bitmap foi carregado com êxito; caso contrário, FALSE.

Comentários

Se o arquivo tiver o atributo somente leitura, a lista de imagens será marcada como somente leitura.

CMFCToolBarImages::LoadStr

BOOL LoadStr(
    LPCTSTR lpszResourceName,
    HINSTANCE hinstRes = NULL,
    BOOL bAdd = FALSE);

Parâmetros

[in] lpszResourceName
[in] hinstRes
[in] bAdd

Valor de retorno

Comentários

CMFCToolBarImages::MapFromSysColor

static COLORREF __stdcall MapFromSysColor(
    COLORREF color,
    BOOL bUseRGBQUAD = TRUE);

Parâmetros

[in] color
[in] bUseRGBQUAD

Valor de retorno

Comentários

CMFCToolBarImages::MapTo3dColors

BOOL MapTo3dColors(
    BOOL bUseRGBQUAD = TRUE,
    COLORREF clrSrc = (COLORREF)-1,
    COLORREF clrDest = (COLORREF)-1);

Parâmetros

[in] bUseRGBQUAD
[in] clrSrc
[in] clrDest

Valor de retorno

Comentários

CMFCToolBarImages::MapToSysColor

static COLORREF __stdcall MapToSysColor(
    COLORREF color,
    BOOL bUseRGBQUAD = TRUE);

Parâmetros

[in] color
[in] bUseRGBQUAD

Valor de retorno

Comentários

CMFCToolBarImages::MapToSysColorAlpha

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

Parâmetros

[in] color

Valor de retorno

Comentários

CMFCToolBarImages::Mirror

Substitui as imagens da barra de ferramentas por sua imagem de espelho horizontal.

BOOL Mirror();

Valor de retorno

TRUE se as imagens foram espelhadas com êxito; caso contrário, FALSE.

Comentários

Esse método é usado para dar suporte a sistemas de escrita da direita para a esquerda.

CMFCToolBarImages::MirrorBitmap

Substitui um bitmap por sua imagem de espelho horizontal.

static BOOL MirrorBitmap(
    HBITMAP& hbmp,
    int cxImage);

Parâmetros

hbmp
[in, out] Um identificador para bitmap a espelhar.

cxImage
[in] Largura da imagem em pixels.

Valor de retorno

TRUE se a imagem foi espelhada com êxito; caso contrário, FALSE.

Comentários

Essa função é usada para dar suporte a sistemas de gravação da direita para a esquerda.

CMFCToolBarImages::MirrorBitmapVert

static BOOL __stdcall MirrorBitmapVert(
    HBITMAP& hbmp,
    int cyImage);

Parâmetros

[in] hbmp
[in] cyImage

Valor de retorno

Comentários

CMFCToolBarImages::MirrorVert

BOOL MirrorVert();

Valor de retorno

Comentários

CMFCToolBarImages::OnSysColorChange

void OnSysColorChange();

Comentários

CMFCToolBarImages::PreMultiplyAlpha

static BOOL __stdcall PreMultiplyAlpha(
    HBITMAP hbmp,
    BOOL bAutoCheckPremlt);

BOOL PreMultiplyAlpha(HBITMAP hbmp);

Parâmetros

[in] hbmp
[in] bAutoCheckPremlt

Valor de retorno

Comentários

CMFCToolBarImages::m_bDisableTrueColorAlpha

TRUE se a combinação alfa truecolor (cor de 32 bits) estiver desabilitada.

static BOOL m_bDisableTrueColorAlpha;

Comentários

Defina essa variável de membro como FALSE para habilitar a combinação alfa truecolor para imagens da barra de ferramentas.

O valor padrão é TRUE para compatibilidade com versões anteriores.

CMFCToolBarImages::PrepareDrawImage

Aloca os recursos necessários para desenhar uma imagem da barra de ferramentas em um tamanho especificado.

BOOL PrepareDrawImage(
    CAfxDrawState& ds,
    CSize sizeImageDest=CSize(0,
    0)
    BOOL bFadeInactive=FALSE);

Parâmetros

ds
[in] Uma referência à estrutura CAfxDrawState, que armazena os recursos alocados entre os estágios de renderização de imagem.

sizeImageDest
[in] Especifica o tamanho de uma imagem de destino.

bFadeInactive
[in] TRUE se você quiser que imagens inativas sejam desenhadas esmaecidas.

Valor de retorno

TRUE se os recursos necessários para desenhar a imagem da barra de ferramentas foram alocados com êxito; caso contrário, FALSE.

Comentários

Depois de chamar esse método, você pode chamar CMFCToolBarImages::Draw qualquer número de vezes. Depois de terminar de desenhar, você deve chamar CMFCToolBarImages::EndDrawImage para liberar os recursos alocados por PrepareDrawImage.

CMFCToolBarImages::Save

Armazenará as imagens da barra de ferramentas em um arquivo se esse conjunto de imagens da barra de ferramentas contiver imagens definidas pelo usuário.

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

Parâmetros

lpszBmpFileName
Um caminho para um arquivo de disco.

Valor de retorno

TRUE se as imagens da barra de ferramentas foram salvas com êxito; caso contrário, FALSE.

Comentários

Chame esse método para armazenar as imagens definidas pelo usuário em um arquivo de disco. Se lpszBmpFileName for NULL, o método armazenará o bitmap no arquivo do qual o bitmap foi carregado pelo método CMFCToolBarImages::Load.

CMFCToolBarImages::SetAlwaysLight

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

Parâmetros

[in] bAlwaysLight

Comentários

CMFCToolBarImages::SetDisabledImageAlpha

Define o valor do canal alfa (opacidade) usado para imagens desabilitadas.

static void SetDisabledImageAlpha(BYTE nValue);

Parâmetros

nValue
[in] O novo valor do canal alfa.

Comentários

Use esse método para definir um valor alfa personalizado para imagens desabilitadas. O valor padrão é 127, o que faz com que as imagens de botão desabilitadas sejam semitransparentes. Se você definir um valor de 0, as imagens desabilitadas serão completamente transparentes. Se você definir um valor de 255, as imagens desabilitadas serão completamente opacas.

CMFCToolBarImages::SetFadedImageAlpha

static void __stdcall SetFadedImageAlpha(BYTE nValue);

Parâmetros

[in] nValue

Comentários

CMFCToolBarImages::SetImageSize

Define o tamanho de cada imagem da barra de ferramentas (tamanho da origem).

void SetImageSize(
    SIZE sizeImage,
    BOOL bUpdateCount=FALSE);

Parâmetros

sizeImage
[in] O novo tamanho das imagens da barra de ferramentas.

Comentários

Por padrão, o tamanho da imagem da barra de ferramentas é de 16 x 15 pixels. Chame esse método se você quiser usar imagens da barra de ferramentas de um tamanho diferente.

CMFCToolBarImages::SetLightPercentage

void SetLightPercentage(int nValue);

Parâmetros

[in] nValue

Comentários

CMFCToolBarImages::SetMapTo3DColors

void SetMapTo3DColors(BOOL bMapTo3DColors);

Parâmetros

[in] bMapTo3DColors

Comentários

CMFCToolBarImages::SetPreMultiplyAutoCheck

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

Parâmetros

[in] bAuto

Comentários

CMFCToolBarImages::SetSingleImage

void SetSingleImage();

Comentários

CMFCToolBarImages::SetTransparentColor

Define a cor transparente das imagens da barra de ferramentas.

COLORREF SetTransparentColor(COLORREF clrTransparent);

Parâmetros

clrTransparent
[in] Um valor RGB.

Valor de retorno

A cor transparente anterior.

Comentários

Quando você ou a estrutura chama CMFCToolBarImages::Draw, o método não desenha nenhum pixel que corresponda à cor especificada por clrTransparent.

CMFCToolBarImages::UpdateImage

Atualiza uma imagem de barra de ferramentas definida pelo usuário com base em um bitmap.

BOOL UpdateImage(
    int iImage,
    HBITMAP hbmp);

Parâmetros

iImage
[in] O índice de base zero da imagem a ser atualizada.

hbmp
[in] Um identificador para o bitmap do qual atualizar a imagem.

Valor de retorno

TRUE se a imagem foi atualizada com êxito; FALSE se a lista de imagens não for definida pelo usuário ou temporária.

CMFCToolBarImages::ConvertTo32Bits

Converte bitmaps sublinhados em imagens de 32 bpp.

BOOL ConvertTo32Bits(COLORREF clrTransparent = (COLORREF)-1);

Parâmetros

clrTransparent
Especifica a cor transparente de bitmaps sublinhados.

Comentários

CMFCToolBarImages::GetBitsPerPixel

Retorna a resolução atual de imagens sublinhadas.

int GetBitsPerPixel() const;

Valor de retorno

Um valor inteiro que representa a resolução atual de imagens sublinhadas, em bits por pixel (bpp).

Comentários

CMFCToolBarImages::GetScale

Retorna a taxa de escala atual de imagens sublinhadas.

double GetScale() const;

Valor de retorno

Um valor que representa a taxa de escala atual.

Comentários

CMFCToolBarImages::IsScaled

Informa se as imagens sublinhadas são dimensionadas ou não.

BOOL IsScaled () const;

Valor de retorno

TRUE se as imagens sublinhadas forem dimensionadas; caso contrário, FALSE.

Comentários

CMFCToolBarImages::SmoothResize

Redimensiona suavemente as imagens sublinhadas.

BOOL SmoothResize(double dblImageScale);

Parâmetros

dblImageScale
Taxa de escala.

Valor de retorno

TRUE se o redimensionamento for bem-sucedido; caso contrário, FALSE.

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CObject
Classe CMFCToolBar
Classe CMFCToolBarButton

Compartilhar via

Classe CMFCToolBarImages

Sintaxe

Membros

Construtores públicos

Métodos públicos

Métodos protegidos

Membros de dados

Comentários

Exemplo

Hierarquia de herança

Requisitos

CMFCToolBarImages::AdaptColors

Parâmetros

Comentários

CMFCToolBarImages::AddIcon

Parâmetros

Valor de retorno

CMFCToolBarImages::AddImage

Parâmetros

Valor de retorno

CMFCToolBarImages::CleanUp

Comentários

CMFCToolBarImages::Clear

CMFCToolBarImages::CMFCToolBarImages

Comentários

CMFCToolBarImages::CopyImageToClipboard

Parâmetros

Valor de retorno

Comentários

CMFCToolBarImages::CopyTo

Parâmetros

Valor de retorno

Comentários

CMFCToolBarImages::CreateFromImageList

Parâmetros

Valor de retorno

Comentários

CMFCToolBarImages::CreateRegionFromImage

Parâmetros

Valor de retorno

Comentários

CMFCToolBarImages::DeleteImage

Parâmetros

Valor de retorno

CMFCToolBarImages::Draw

Parâmetros

Valor de retorno

CMFCToolBarImages::DrawEx

Parâmetros

Valor de retorno

Comentários

CMFCToolBarImages::EnableRTL

Parâmetros

Comentários

CMFCToolBarImages::EndDrawImage

Parâmetros

CMFCToolBarImages::ExtractIcon

Parâmetros

Valor de retorno

CMFCToolBarImages::FillDitheredRect

Parâmetros

Comentários

CMFCToolBarImages::GetAlwaysLight

Valor de retorno

Comentários

CMFCToolBarImages::GetCount

Valor de retorno

CMFCToolBarImages::GetDisabledImageAlpha

Valor de retorno

Comentários

CMFCToolBarImages::GetFadedImageAlpha

Valor de retorno

Comentários

CMFCToolBarImages::GetImageSize

Parâmetros

Valor de retorno

Comentários

CMFCToolBarImages::GetImageWell

Valor de retorno