Classe CMFCToolBarImages
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
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