Classe CMFCToolBarImages

As imagens numa barra de ferramentas. A CMFCToolBarImages classe gere imagens da barra de ferramentas carregadas a partir de recursos da aplicação ou de ficheiros. Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCToolBarImages : public CObject

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Membros de Dados

Observações

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

Example

O exemplo seguinte demonstra como configurar um CMFCToolBarImages objeto usando vários métodos na CMFCToolBarImages classe. O exemplo mostra como definir o tamanho da imagem da barra de ferramentas, carregar uma imagem e definir a cor transparente da imagem. Este excerto 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

Requerimentos

Cabeçalho: afxtoolbarimages.h

CMFCToolBarImages::AdaptColors

void AdaptColors(
    COLORREF clrBase,
    COLORREF clrTone);

Parâmetros

[dentro] clrBase
[dentro] clrTone

Observações

CMFCToolBarImages::AddIcon

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

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

Parâmetros

hIcon
[dentro] Uma alça para o ícone a ser adicionado.

bAlphaBlend
[dentro] TRUE se este ícone for usado com alpha blending; caso contrário, FALSO.

Valor de retorno

O índice em base 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
[dentro] O handler do bitmap para adicionar.

bSetBitPerPixel
[dentro] TRUE se o CMFCToolBarImages objeto usar a profundidade de cor (bits por pixel) da nova imagem; FALSE se o CMFCToolbarImages objeto mantiver a profundidade de cor atual.

imageLista
[dentro] Uma referência a um CMFCToolbarImages objeto que contém a imagem a adicionar.

nIndex
[dentro] O índice no objeto de origem CMFCToolbarImages da imagem a adicionar.

Valor de retorno

O número de imagens da barra de ferramentas que o CMFCToolBarImages objeto mantém após a adição com sucesso do novo bitmap; -1 se a operação falhasse.

CMFCToolBarImages::CleanUp

static void __stdcall CleanUp();

Observações

CMFCToolBarImages::Limpar

Liberta os recursos do sistema que o objeto CMFCToolbarImages alocou.

void Clear();

CMFCToolBarImages::CMFCToolBarImages

Constrói um CMFCToolBarImages objeto.

CMFCToolBarImages();

Observações

Constrói um CMFCToolBarImages objeto, inicializa o seu motor de renderização e define o tamanho da imagem para o seu valor padrão 16x15 píxeis. Usa CMFCToolBarImages::SetImageSize para alterar o tamanho da imagem antes de adicionares imagens.

CMFCToolBarImages::CopyImageToClipboard

BOOL CopyImageToClipboard(int iImage);

Parâmetros

[dentro] iImage

Valor de retorno

Observações

CMFCToolBarImages::CopyTo

BOOL CopyTo(CMFCToolBarImages& imageList);

Parâmetros

[dentro] imageLista

Valor de retorno

Observações

CMFCToolBarImages::CreateFromImageList

Inicializa as imagens da barra de ferramentas a partir de um objeto CImageList Class .

BOOL CreateFromImageList(const CImageList& imageList);

Parâmetros

imageLista
[dentro] A lista de imagens será usada como fonte para imagens da barra de ferramentas.

Valor de retorno

Retorna sempre VERDADEIRO.

Observações

Use esta função para inicializar rapidamente a lista de imagens da barra de ferramentas a partir de uma lista externa.

CMFCToolBarImages::CreateRegionFromImage

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

Parâmetros

[dentro] BMP
[dentro] clrTransparent

Valor de retorno

Observações

CMFCToolBarImages::D eleteImagemT

Apaga a imagem definida pelo utilizador que tem um índice especificado das imagens da barra de ferramentas.

BOOL DeleteImage(int iImage);

Parâmetros

iImage
[dentro] Especifica o índice base zero da imagem a eliminar.

Valor de retorno

TRUE se a imagem foi eliminada com sucesso; FALSE se o índice de imagem for inválido, o CMFCToolbarImages objeto for temporário, o CMFCToolbarImages objeto não contiver imagens definidas pelo utilizador, ou se ocorreu algum outro erro.

CMFCToolBarImages::D raw

Desenha uma única 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
[dentro] Um apontador para o contexto de um dispositivo.

x
[dentro] A coordenada X do lado esquerdo do retângulo onde a imagem deve ser desenhada.

y
[dentro] A coordenada Y do topo do retângulo onde a imagem deve ser desenhada.

iImageIndex
[dentro] O índice em base zero da imagem a ser apresentada.

bHilite
[dentro] VERDADEIRO se a imagem for para ser destacada; caso contrário, FALSO.

bDeficiente
[dentro] VERDADEIRO se a imagem for desenhada no estilo para pessoas com deficiência; caso contrário, FALSO.

bIndeterminado
[dentro] VERDADEIRO se a imagem for desenhada no estilo de estado indeterminado; caso contrário, FALSO.

bShadow
[dentro] VERDADEIRO se a imagem for desenhada com sombra; caso contrário, FALSO.

bInativo
[dentro] TRUE se a imagem for desenhada no estilo de estado inativo; caso contrário, FALSO.

alphaSrc
[dentro] 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. Este valor é usado apenas para imagens a cores de 32 bits e para imagens que apresentam um estilo de vidro Windows Vista.

Valor de retorno

TRUE se a imagem especificada foi exibida com sucesso; FALSE se o índice da imagem fosse inválido ou se ocorrer algum outro erro.

CMFCToolBarImages::D rawEx

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

[dentro] pDC
[dentro] Rect
[dentro] iImageIndex
[dentro] horzAlign
[dentro] vertAlign
[dentro] rectSrc
[dentro] alphaSrc

Valor de retorno

Observações

CMFCToolBarImages::EnableRTL

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

Parâmetros

[dentro] bIsRTL

Observações

CMFCToolBarImages::EndDrawImage

Liberta recursos do sistema que o CMFCToolBarImages::P repareDrawImage aloca depois de desenhar uma imagem da barra de ferramentas, chamando CMFCToolBarImages::D raw.

void EndDrawImage(CAfxDrawState& ds);

Parâmetros

ds
[dentro] Uma referência ao CAfxDrawState objeto que foi passado ao PrepareDrawImage método.

CMFCToolBarImages::ExtractIcon

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

HICON ExtractIcon(int nIndex);

Parâmetros

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

Valor de retorno

Um handle para o ícone extraído, ou NULL se o nIndex estiver fora do alcance.

CMFCToolBarImages::FillDitheredRect

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

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

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] As coordenadas de um retângulo para preencher.

Observações

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

CMFCToolBarImages::GetAlwaysLight

BOOL GetAlwaysLight() const;

Valor de retorno

Observações

CMFCToolBarImages::GetCount

Devolve 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 CMFCToolBarImages objeto.

CMFCToolBarImages::GetDisabledImageAlpha

Devolve o valor do canal alfa (opacidade) que é usado para imagens desativadas.

static BYTE GetDisabledImageAlpha();

Valor de retorno

O valor atual do canal alfa.

Observações

Pode ligar para CMFCToolBarImages::SetDisabledImageAlpha para alterar o valor do canal alfa.

CMFCToolBarImages::GetFadedImageAlpha

static BYTE __stdcall GetFadedImageAlpha();

Valor de retorno

Observações

CMFCToolBarImages::GetImageSize

Recupera ou o tamanho das imagens da barra de ferramentas armazenadas na memória (tamanho da fonte), ou o tamanho das imagens da barra de ferramentas desenhadas no ecrã (tamanho de destino).

SIZE GetImageSize(BOOL bDest=FALSE) const;

Parâmetros

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

Valor de retorno

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

Observações

O tamanho da imagem de origem é o tamanho das imagens armazenadas no objeto CMFCToolbarImages . Pode chamar o CMFCToolBarImages::SetImageSize para definir o tamanho da fonte. O valor padrão é 16x15 píxeis.

Por defeito, o tamanho da imagem de destino é 0x0. Especifica o tamanho do destino quando chama CMFCToolBarImages::P repareDrawImage. O método CMFCToolBarImages::EndDrawImage redefine o tamanho do destino para o valor padrão.

CMFCToolBarImages::GetImageWell

Devolve o handle ao bitmap que contém todas as imagens da barra de ferramentas.

HBITMAP GetImageWell() const;

Valor de retorno

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

Observações

As imagens da barra de ferramentas são armazenadas numa linha num único bitmap conhecido como poço de imagem. Para encontrar uma imagem da barra de ferramentas no poço da imagem, multiplique o índice da imagem pela largura das imagens da barra de ferramentas (ver CMFCToolBarImages::GetImageSize) para obter o deslocamento horizontal da imagem dentro do poço da imagem.

CMFCToolBarImages::GetImageWellLight

HBITMAP GetImageWellLight() const;

Valor de retorno

Observações

CMFCToolBarImages::GetLastImageRect

CRect GetLastImageRect() const;

Valor de retorno

Observações

CMFCToolBarImages::GetLightPercentage

int GetLightPercentage() const;

Valor de retorno

Observações

CMFCToolBarImages::GetMapTo3DColors

BOOL GetMapTo3DColors() const;

Valor de retorno

Observações

CMFCToolBarImages::GetMask

HBITMAP GetMask(int iImage);

Parâmetros

[dentro] iImage

Valor de retorno

Observações

CMFCToolBarImages::GetResourceOffset

Devolve o índice da imagem para um ID de recurso especificado.

int GetResourceOffset(UINT uiResId) const;

Parâmetros

uiResId
[dentro] Um ID de recurso com imagem.

Valor de retorno

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

CMFCToolBarImages::GetTransparentColor

COLORREF GetTransparentColor() const;

Valor de retorno

Observações

CMFCToolBarImages::GrayImages

Encinzenta as imagens da barra de ferramentas para que pareçam desativadas.

BOOL GrayImages(int nGrayImageLuminancePercentage);

Parâmetros

nGrayImageLuminancePercentageT
[dentro] Percentagem de luminância.

Valor de retorno

VERDADE se as imagens da coleção foram acentizadas com sucesso; caso contrário, FALSO.

Observações

Este método modifica as imagens da barra de ferramentas fazendo a média dos componentes vermelho, verde e azul de cada píxel e multiplicando o resultado por nGrayImageLuminancePercentage dividido por 100. Se nGrayImageLuminancePercentage for zero ou negativo, utiliza-se o valor padrão de 130.

CMFCToolBarImages::Is32BitTransparencySuportado

Especifica se o sistema operativo suporta mistura alfa de 32 bits.

static BOOL Is32BitTransparencySupported();

Valor de retorno

TRUE se for suportada a mistura alfa de 32 bits; caso contrário, FALSO.

Observações

Use este método estático para determinar em tempo de execução se o sistema operativo suporta mistura alfa de 32 bits. Esta funcionalidade é suportada no Windows 2000 e versões posteriores.

CMFCToolBarImages::IsPreMultiplyAutoCheck

BOOL IsPreMultiplyAutoCheck() const;

Valor de retorno

Observações

CMFCToolBarImages::IsReadOnly

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

BOOL IsReadOnly() const;

Valor de retorno

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

Observações

O CMFCToolbarImages objeto é apenas de leitura quando o bitmap com imagens da barra de ferramentas foi carregado a partir de um ficheiro de apenas leitura, ou quando o bitmap foi copiado usando o CMFCToolBarImages::CopyTemp método.

CMFCToolBarImages::IsRTL

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

static BOOL IsRTL();

Valor de retorno

TRUE se o suporte RTL estiver ativado; caso contrário, FALSO.

Observações

O suporte RTL é utilizado quando a aplicação é localizada para uma língua lida da direita para a esquerda, como árabe, hebraico, persa ou urdu.

CMFCToolBarImages::IsUserImagesList

Especifica se este conjunto de imagens da barra de ferramentas contém imagens definidas pelo utilizador.

BOOL IsUserImagesList() const;

Valor de retorno

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

CMFCToolBarImages::IsValid

Indica se este 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 CMFCToolBarImages objeto for válido; caso contrário, FALSE.

Observações

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

CMFCToolBarImages::Carregar

Carrega imagens da barra de ferramentas a partir de recursos do sistema ou de um ficheiro.

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

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

Parâmetros

uiResID
[dentro] O ID de um recurso bitmap.

hinstRes
[dentro] Uma instância da DLL de recursos.

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

lpszBmpFileName
[dentro] Um caminho para um ficheiro de disco a partir do qual carregar o bitmap.

nMaxFileSize
[dentro] Número máximo de bytes no ficheiro bitmap; ou 0 para carregar o bitmap independentemente do tamanho do ficheiro. Se o tamanho do ficheiro exceder este tamanho máximo, o método devolve FALSE e não carrega o bitmap.

Valor de retorno

TRUE se o bitmap foi carregado com sucesso; caso contrário, FALSO.

Observações

Se o ficheiro tiver o atributo de apenas leitura, a lista de imagens é marcada como apenas de leitura.

CMFCToolBarImages::LoadStr

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

Parâmetros

[dentro] lpszResourceName
[dentro] hinstRes
[dentro] bAdd

Valor de retorno

Observações

CMFCToolBarImages::MapFromSysColor

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

Parâmetros

[dentro] Cor
[dentro] bUseRGBQUAD

Valor de retorno

Observações

CMFCToolBarImages::MapTo3dColors

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

Parâmetros

[dentro] bUseRGBQUAD
[dentro] clrSrc
[dentro] clrDest

Valor de retorno

Observações

CMFCToolBarImages::MapToSysColor

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

Parâmetros

[dentro] Cor
[dentro] bUseRGBQUAD

Valor de retorno

Observações

CMFCToolBarImages::MapToSysColorAlpha

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

Parâmetros

[dentro] Cor

Valor de retorno

Observações

CMFCToolBarImages::Espelho

Substitui as imagens da barra de ferramentas pela sua imagem horizontal espelhada.

BOOL Mirror();

Valor de retorno

TRUE se as imagens foram espelhadas com sucesso; caso contrário, FALSO.

Observações

Este método é usado para suportar sistemas de escrita da direita para a esquerda.

CMFCToolBarImages::MirrorBitmap

Substitui um bitmap pela sua imagem espelhada horizontal.

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

Parâmetros

HBMP
[inspira, expira] Um handle para bitmap e depois espelho.

cxImage
[dentro] Largura da imagem em pixels.

Valor de retorno

TRUE se a imagem foi espelhada com sucesso; caso contrário, FALSO.

Observações

Esta função é usada para suportar sistemas de escrita da direita para a esquerda.

CMFCToolBarImages::MirrorBitmapVert

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

Parâmetros

[dentro] HBMP
[dentro] cyImage

Valor de retorno

Observações

CMFCToolBarImages::MirrorVert

BOOL MirrorVert();

Valor de retorno

Observações

CMFCToolBarImages::OnSysColorChange

void OnSysColorChange();

Observações

CMFCToolBarImages::P reMultiplyAlpha

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

BOOL PreMultiplyAlpha(HBITMAP hbmp);

Parâmetros

[dentro] HBMP
[dentro] bAutoCheckPremlt

Valor de retorno

Observações

CMFCToolBarImages::m_bDisableTrueColorAlpha

TRUE se a mistura alfa truecolor (cor de 32 bits) estiver desativada.

static BOOL m_bDisableTrueColorAlpha;

Observações

Defina esta variável membro para FALSE para permitir a mistura alfa de cores verdadeiras para imagens da barra de ferramentas.

O valor padrão é VERDADEIRO para compatibilidade retroativa.

CMFCToolBarImages::P repareDrawImageT

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

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

Parâmetros

ds
[dentro] Uma referência à CAfxDrawState estrutura, que armazena os recursos alocados entre as fases de renderização da imagem.

tamanhoImageDest
[dentro] Especifica o tamanho de uma imagem de destino.

bFadeInativo
[dentro] VERDADE, se quiseres que imagens inativas sejam desenhadas desbotadas.

Valor de retorno

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

Observações

Depois de chamar este método, pode chamar CMFCToolBarImages::D raw o número de vezes que quiser. Depois de terminar o desenho, deve ligar para CMFCToolBarImages::EndDrawImage para libertar os recursos alocados por PrepareDrawImage.

CMFCToolBarImages::Guardar

Armazena as imagens da barra de ferramentas num ficheiro se este conjunto de imagens da barra de ferramentas contiver imagens definidas pelo utilizador.

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

Parâmetros

lpszBmpFileName
Um caminho para um ficheiro de disco.

Valor de retorno

TRUE se as imagens da barra de ferramentas forem guardadas com sucesso; caso contrário, FALSO.

Observações

Chame este método para armazenar as imagens definidas pelo utilizador num ficheiro de disco. Se lpszBmpFileName for NULL, o método armazena o bitmap no ficheiro a partir do qual o bitmap foi carregado pelo método CMFCToolBarImages::Load .

CMFCToolBarImages::SetAlwaysLight

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

Parâmetros

[dentro] bSempreLuz

Observações

CMFCToolBarImages::SetDisabledImageAlpha

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

static void SetDisabledImageAlpha(BYTE nValue);

Parâmetros

nValor
[dentro] O novo valor do canal alfa.

Observações

Use este método para definir um valor alfa personalizado para imagens desativadas. O valor padrão é 127, o que faz com que as imagens dos botões desativados fiquem semitransparentes. Se definir um valor de 0, as imagens desativadas ficarão completamente transparentes. Se definires um valor de 255, as imagens desativadas ficarão completamente opacas.

CMFCToolBarImages::SetFadedImageAlpha

static void __stdcall SetFadedImageAlpha(BYTE nValue);

Parâmetros

[dentro] nValor

Observações

CMFCToolBarImages::SetImageSize

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

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

Parâmetros

tamanhoImagem
[dentro] O novo tamanho das imagens da barra de ferramentas.

Observações

Por defeito, o tamanho da imagem da barra de ferramentas é 16x15 píxeis. Chame a este método se quiser usar imagens da barra de ferramentas de tamanho diferente.

CMFCToolBarImages::SetLightPercentage

void SetLightPercentage(int nValue);

Parâmetros

[dentro] nValor

Observações

CMFCToolBarImages::SetMapTo3DColors

void SetMapTo3DColors(BOOL bMapTo3DColors);

Parâmetros

[dentro] bMapTo3DColors

Observações

CMFCToolBarImages::SetPreMultiplyAutoCheck

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

Parâmetros

[dentro] bAuto

Observações

CMFCToolBarImages::SetSingleImage

void SetSingleImage();

Observações

CMFCToolBarImages::SetTransparentColor

Define a cor transparente das imagens da barra de ferramentas.

COLORREF SetTransparentColor(COLORREF clrTransparent);

Parâmetros

clrTransparent
[dentro] Um valor RGB.

Valor de retorno

A cor transparente anterior.

Observações

Quando tu ou o framework chamam CMFCToolBarImages::D raw, o método não desenha nenhum pixel que corresponda à cor especificada pelo clrTransparent.

CMFCToolBarImages::UpdateImage

Atualiza uma imagem de barra de ferramentas definida pelo utilizador a partir de um bitmap.

BOOL UpdateImage(
    int iImage,
    HBITMAP hbmp);

Parâmetros

iImage
[dentro] O índice em base zero da imagem para atualizar.

HBMP
[dentro] Um handler para o bitmap a partir do qual atualizar a imagem.

Valor de retorno

TRUE se a imagem foi atualizada com sucesso; FALSE se a lista de imagens não for definida pelo utilizador 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 dos bitmaps sublinhados.

Observações

CMFCToolBarImages::GetBitsPerPixel

Devolve a resolução atual das imagens sublinhadas.

int GetBitsPerPixel() const;

Valor de retorno

Um valor inteiro que representa a resolução atual das imagens sublinhadas, em bits por píxel (bpp).

Observações

CMFCToolBarImages::GetScale

Devolve a proporção de escala atual das imagens sublinhadas.

double GetScale() const;

Valor de retorno

Um valor que representa a razão atual da escala.

Observações

CMFCToolBarImages::IsScaled

Indica se as imagens sublinhadas estão dimensionadas ou não.

BOOL IsScaled () const;

Valor de retorno

TRUE se as imagens sublinhadas forem escaladas; caso contrário, FALSO.

Observações

CMFCToolBarImages::SmoothResize

Redimensiona suavemente imagens sublinhadas.

BOOL SmoothResize(double dblImageScale);

Parâmetros

dblImageScale
Proporção de escala.

Valor de retorno

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

Observações

Consulte também

Gráfico de Hierarquia
Classes
CObject Classe
Classe CMFCToolBar
Classe CMFCToolBarButton