CMFCToolBarImages (clase)

Artículo
06/16/2023

Imágenes de una barra de herramientas. La clase CMFCToolBarImages administra imágenes de la barra de herramientas que se cargan de recursos de la aplicación o de archivos. Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Sintaxis

class CMFCToolBarImages : public CObject

Miembros

Constructores públicos

Nombre	Descripción
CMFCToolBarImages::CMFCToolBarImages	Construye un objeto `CMFCToolBarImages`.

Métodos públicos

Nombre	Descripción
CMFCToolBarImages::AdaptColors
CMFCToolBarImages::AddIcon	Agrega un icono a las imágenes de la barra de herramientas.
CMFCToolBarImages::AddImage	Agrega un mapa de bits a las imágenes de la barra de herramientas.
CMFCToolBarImages::CleanUp
CMFCToolBarImages::Clear	Libera los recursos del sistema que se asignaron a este objeto.
CMFCToolBarImages::ConvertTo32Bits	Convierte los mapas de bits subrayados en imágenes de 32 bpp.
CMFCToolBarImages::CopyImageToClipboard
CMFCToolBarImages::CopyTo
CMFCToolBarImages::CreateFromImageList	Inicializa las imágenes de la barra de herramientas desde una lista de imágenes (clase CImageList).
CMFCToolBarImages::CreateRegionFromImage
CMFCToolBarImages::DeleteImage	Elimina la imagen que tiene un índice especificado de las imágenes de la barra de herramientas si este conjunto de imágenes de la barra de herramientas contiene imágenes definidas por el usuario.
CMFCToolBarImages::Draw	Dibuja una sola imagen de la barra de herramientas (botón).
CMFCToolBarImages::DrawEx
CMFCToolBarImages::EnableRTL
CMFCToolBarImages::EndDrawImage	Libera los recursos del sistema después de dibujar una imagen de la barra de herramientas.
CMFCToolBarImages::ExtractIcon	Devuelve el icono que tiene un índice de imagen especificado a partir de las imágenes de la barra de herramientas.
CMFCToolBarImages::FillDitheredRect	Rellena un rectángulo mediante un pincel que tiene los colores de fondo de la barra de herramientas.
CMFCToolBarImages::GetAlwaysLight
CMFCToolBarImages::GetBitsPerPixel	Devuelve la resolución actual de las imágenes subrayadas.
CMFCToolBarImages::GetCount	Devuelve el número de imágenes de la barra de herramientas.
CMFCToolBarImages::GetDisabledImageAlpha	Devuelve el valor del canal alfa que se usa para las imágenes deshabilitadas.
CMFCToolBarImages::GetFadedImageAlpha
CMFCToolBarImages::GetImageSize	Recupera el tamaño de las imágenes de la barra de herramientas almacenadas en memoria (tamaño de origen) o el tamaño de las imágenes de la barra de herramientas que se dibujan en la pantalla (tamaño de destino).
CMFCToolBarImages::GetImageWell	Devuelve el identificador al mapa de bits que contiene todas las imágenes de la barra de herramientas.
CMFCToolBarImages::GetImageWellLight
CMFCToolBarImages::GetLastImageRect
CMFCToolBarImages::GetLightPercentage
CMFCToolBarImages::GetMapTo3DColors
CMFCToolBarImages::GetMask
CMFCToolBarImages::GetResourceOffset	Devuelve el índice de imagen para un identificador de recurso especificado.
CMFCToolBarImages::GetScale	Devuelve la relación de escala actual de imágenes subrayadas.
CMFCToolBarImages::GetTransparentColor
CMFCToolBarImages::GrayImages	Atenúa las imágenes de la barra de herramientas para que se vean deshabilitadas.
CMFCToolBarImages::Is32BitTransparencySupported	Determina si el sistema operativo actual admite la combinación alfa de 32 bits.
CMFCToolBarImages::IsPreMultiplyAutoCheck
CMFCToolBarImages::IsRTL	Determina si la compatibilidad de derecha a izquierda (RTL) está habilitada.
CMFCToolBarImages::IsReadOnly	Determina si las imágenes de la barra de herramientas son de solo lectura.
CMFCToolBarImages::IsScaled	Indica si las imágenes subrayadas se escalan o no.
CMFCToolBarImages::IsUserImagesList	Determina si este conjunto de imágenes de la barra de herramientas contiene imágenes definidas por el usuario.
CMFCToolBarImages::IsValid	Determina si este conjunto de imágenes de la barra de herramientas contiene una imagen válida de la barra de herramientas.
CMFCToolBarImages::Load	Carga imágenes de la barra de herramientas desde los recursos del sistema o desde un archivo.
CMFCToolBarImages::LoadStr
CMFCToolBarImages::MapFromSysColor
CMFCToolBarImages::MapTo3dColors
CMFCToolBarImages::MapToSysColor
CMFCToolBarImages::MapToSysColorAlpha
CMFCToolBarImages::Mirror	Refleja horizontalmente todas las imágenes de la barra de herramientas.
CMFCToolBarImages::MirrorBitmap	Refleja horizontalmente un mapa de bits.
CMFCToolBarImages::MirrorBitmapVert
CMFCToolBarImages::MirrorVert
CMFCToolBarImages::OnSysColorChange
CMFCToolBarImages::PrepareDrawImage	Asigna los recursos necesarios para dibujar una imagen de la barra de herramientas con un tamaño especificado.
CMFCToolBarImages::Save	Almacena las imágenes de la barra de herramientas en un archivo si este conjunto de imágenes de la barra de herramientas contiene imágenes definidas por el usuario.
CMFCToolBarImages::SetAlwaysLight
CMFCToolBarImages::SetDisabledImageAlpha	Establece el valor del canal alfa que se usa para las imágenes deshabilitadas.
CMFCToolBarImages::SetFadedImageAlpha
CMFCToolBarImages::SetImageSize	Establece el tamaño de una imagen de barra de herramientas (tamaño de origen).
CMFCToolBarImages::SetLightPercentage
CMFCToolBarImages::SetMapTo3DColors
CMFCToolBarImages::SetPreMultiplyAutoCheck
CMFCToolBarImages::SetSingleImage
CMFCToolBarImages::SetTransparentColor	Establece el color transparente de las imágenes de la barra de herramientas.
CMFCToolBarImages::SmoothResize	Cambia ligeramente el tamaño de las imágenes subrayadas.
CMFCToolBarImages::UpdateImage	Actualiza una imagen de la barra de herramientas definida por el usuario desde un mapa de bits.

Métodos protegidos

Nombre	Descripción
CMFCToolBarImages::PreMultiplyAlpha

Miembros de datos

Nombre	Descripción
CMFCToolBarImages::m_bDisableTrueColorAlpha	TRUE si la combinación alfa truecolor (color de 32 bits) está deshabilitada.

Comentarios

El mapa de bits completo de imágenes de la barra de herramientas administradas por CMFCToolbarImages consta de una o varias imágenes de barra de herramientas pequeñas (botones) de un tamaño fijo.

Ejemplo

En el ejemplo siguiente se muestra cómo configurar un objeto CMFCToolBarImages mediante varios métodos de la clase CMFCToolBarImages. En el ejemplo se muestra cómo establecer el tamaño de la imagen de la barra de herramientas, cargar una imagen y establecer el color transparente de la imagen. Este fragmento de código forma parte del ejemplo de demostración de Visual Studio.

CMFCToolBarImages m_Image;

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

Jerarquía de herencia

CObject

CMFCToolBarImages

Requisitos

Encabezado: afxtoolbarimages.h

CMFCToolBarImages::AdaptColors

void AdaptColors(
    COLORREF clrBase,
    COLORREF clrTone);

Parámetros

[in] clrBase
[in] clrTone

Comentarios

CMFCToolBarImages::AddIcon

Agrega un icono a la lista de imágenes de la barra de herramientas.

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

Parámetros

hIcon
[in] Identificador del icono que se vaya a agregar.

bAlphaBlend
[in] TRUE si este icono se utiliza con combinación alfa; en caso contrario, FALSE.

Valor devuelto

Índice de base cero de la imagen de la barra de herramientas que se agregó si el método es correcto; en caso contrario, -1.

CMFCToolBarImages::AddImage

Agrega un mapa de bits a las imágenes de la barra de herramientas.

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

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

Parámetros

hbmp
[in] Manipulador del mapa de bits que se va a agregar.

bSetBitPerPixel
[in] TRUE si el objeto CMFCToolBarImages usa la profundidad de color (bits por píxel) de la nueva imagen; FALSE si el objeto CMFCToolbarImages mantiene la profundidad de color actual.

imageList
[in] Referencia a un objeto CMFCToolbarImages que contiene la imagen que se va a agregar.

nIndex
[in] Índice del objeto CMFCToolbarImages de origen de la imagen que se va a agregar.

Valor devuelto

Número de imágenes de la barra de herramientas que mantiene el objeto CMFCToolBarImages después de que el nuevo mapa de bits se haya agregado correctamente; -1 si se produjo un error en la operación.

CMFCToolBarImages::CleanUp

static void __stdcall CleanUp();

Comentarios

CMFCToolBarImages::Clear

Libera los recursos del sistema que el objeto CMFCToolbarImages asignó.

void Clear();

CMFCToolBarImages::CMFCToolBarImages

Construye un objeto CMFCToolBarImages.

CMFCToolBarImages();

Comentarios

Construye un objeto CMFCToolBarImages, inicializa su motor de representación y establece el tamaño de la imagen en su valor predeterminado de 16 x 15 píxeles. Use CMFCToolBarImages::SetImageSize para cambiar el tamaño de la imagen antes de agregar imágenes.

CMFCToolBarImages::CopyImageToClipboard

BOOL CopyImageToClipboard(int iImage);

Parámetros

[in] iImage

Valor devuelto

Comentarios

CMFCToolBarImages::CopyTo

BOOL CopyTo(CMFCToolBarImages& imageList);

Parámetros

[in] imageList

Valor devuelto

Comentarios

CMFCToolBarImages::CreateFromImageList

Inicializa las imágenes de la barra de herramientas desde un objeto CImageList (clase).

BOOL CreateFromImageList(const CImageList& imageList);

Parámetros

imageList
[in] Lista de imágenes que se va a usar como origen para las imágenes de la barra de herramientas.

Valor devuelto

Siempre devuelve TRUE.

Comentarios

Use esta función para inicializar rápidamente la lista de imágenes de la barra de herramientas desde una lista de imágenes externas.

CMFCToolBarImages::CreateRegionFromImage

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

Parámetros

[in] bmp
[in] clrTransparent

Valor devuelto

Comentarios

CMFCToolBarImages::DeleteImage

Elimina la imagen definida por el usuario que tiene un índice especificado a partir de las imágenes de la barra de herramientas.

BOOL DeleteImage(int iImage);

Parámetros

iImage
[in] Especifica el índice de base cero de la imagen que se va a eliminar.

Valor devuelto

TRUE si la imagen se eliminó correctamente; FALSE si el índice de imagen no es válido, el objeto CMFCToolbarImages es temporal, el objeto CMFCToolbarImages no contiene imágenes definidas por el usuario o si se produjo algún otro error.

CMFCToolBarImages::Draw

Dibuja una sola imagen de la barra de herramientas.

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] Puntero a un contexto de dispositivo.

x
[in] Coordenada X del lado izquierdo del rectángulo donde se va a dibujar la imagen.

y
[in] Coordenada Y de la parte superior del rectángulo donde se va a dibujar la imagen.

iImageIndex
[in] Índice de base cero de la imagen que se va a mostrar.

bHilite
[in] TRUE si se va a resaltar la imagen; en caso contrario, FALSE.

bDisabled
[in] TRUE si la imagen se va a dibujar con el estilo deshabilitado; en caso contrario, FALSE.

bIndeterminate
[in] TRUE si la imagen se va a dibujar en el estilo de estado indeterminado; en caso contrario, FALSE.

bShadow
[in] TRUE si la imagen se va a dibujar con una sombra paralela; en caso contrario, FALSE.

bInactive
[in] TRUE si la imagen se va a dibujar en el estilo de estado inactivo; en caso contrario, FALSE.

alphaSrc
[in] Valor del canal alfa (opacidad). Un valor de 255 significa que la imagen se dibuja opaca. Un valor de 0 significa que la imagen se dibuja transparente. Este valor solo se usa para imágenes en color de 32 bits y para imágenes que muestran un estilo de cristal de Windows Vista.

Valor devuelto

TRUE si la imagen especificada se mostró correctamente; FALSE si el índice de imagen no era válido o si se produjo algún otro error.

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 devuelto

Comentarios

CMFCToolBarImages::EnableRTL

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

Parámetros

[in] bIsRTL

Comentarios

CMFCToolBarImages::EndDrawImage

Libera los recursos del sistema que CMFCToolBarImages::PrepareDrawImage asignó después de dibujar una imagen de la barra de herramientas llamando a CMFCToolBarImages::Draw.

void EndDrawImage(CAfxDrawState& ds);

Parámetros

ds
[in] Referencia al objeto CAfxDrawState que se pasó al método PrepareDrawImage.

CMFCToolBarImages::ExtractIcon

Devuelve el icono que tiene un índice de imagen especificado a partir de las imágenes de la barra de herramientas.

HICON ExtractIcon(int nIndex);

Parámetros

nIndex
[in] Índice de base cero de la lista de imágenes en la que se encuentra la imagen que se va a extraer como un icono.

Valor devuelto

Identificador del icono extraído o NULL si nIndex está fuera del intervalo.

CMFCToolBarImages::FillDitheredRect

Rellena un rectángulo con los colores de fondo de la barra de herramientas.

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

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

rect
[in] Coordenadas de un rectángulo que se va a rellenar.

Comentarios

Utilice este método para rellenar un rectángulo con un color que sea el promedio de los colores del sistema COLOR_BTNFACE y COLOR_BTNHIGHLIGHT. Si el sistema usa 256 colores o menos, en su lugar, el rectángulo se rellenará con un patrón interpolado de esos dos colores.

CMFCToolBarImages::GetAlwaysLight

BOOL GetAlwaysLight() const;

Valor devuelto

Comentarios

CMFCToolBarImages::GetCount

Devuelve el número de imágenes de la lista de imágenes de la barra de herramientas.

int GetCount() const;

Valor devuelto

El número de imágenes del objeto CMFCToolBarImages.

CMFCToolBarImages::GetDisabledImageAlpha

Devuelve el valor del canal alfa (opacidad) que se usa para las imágenes deshabilitadas.

static BYTE GetDisabledImageAlpha();

Valor devuelto

Valor del canal alfa actual.

Comentarios

Puedes llamar a CMFCToolBarImages::SetDisabledImageAlpha para cambiar el valor del canal alfa.

CMFCToolBarImages::GetFadedImageAlpha

static BYTE __stdcall GetFadedImageAlpha();

Valor devuelto

Comentarios

CMFCToolBarImages::GetImageSize

Recupera el tamaño de las imágenes de la barra de herramientas almacenadas en memoria (tamaño de origen) o el tamaño de las imágenes de la barra de herramientas que se dibujan en la pantalla (tamaño de destino).

SIZE GetImageSize(BOOL bDest=FALSE) const;

Parámetros

bDest
[in] TRUE para recuperar el tamaño de destino; FALSE para recuperar el tamaño de la imagen de origen.

Valor devuelto

Estructura SIZE, que especifica el tamaño de una imagen en píxeles.

Comentarios

El tamaño de la imagen de origen es el tamaño de las imágenes almacenadas en el objeto CMFCToolbarImages. Puede llamar a CMFCToolBarImages::SetImageSize para establecer el tamaño de origen. El valor predeterminado es 16x15 píxeles.

De forma predeterminada, el tamaño de la imagen de destino es 0x0. Especifique el tamaño de destino al llamar a CMFCToolBarImages::PrepareDrawImage. El método CMFCToolBarImages::EndDrawImage restablece el tamaño de destino al valor predeterminado.

CMFCToolBarImages::GetImageWell

Devuelve el identificador al mapa de bits que contiene todas las imágenes de la barra de herramientas.

HBITMAP GetImageWell() const;

Valor devuelto

Identificador de un mapa de bits que contiene imágenes de la barra de herramientas.

Comentarios

Las imágenes de la barra de herramientas se almacenan en una fila en un solo mapa de bits conocido también como un mapa de bits de imágenes. Para buscar una imagen de barra de herramientas en el mapa de bits de imágenes, multiplique el índice de la imagen por el ancho de las imágenes de la barra de herramientas (vea CMFCToolBarImages::GetImageSize) para obtener el desplazamiento horizontal de la imagen dentro del mapa de bits de imágenes.

CMFCToolBarImages::GetImageWellLight

HBITMAP GetImageWellLight() const;

Valor devuelto

Comentarios

CMFCToolBarImages::GetLastImageRect

CRect GetLastImageRect() const;

Valor devuelto

Comentarios

CMFCToolBarImages::GetLightPercentage

int GetLightPercentage() const;

Valor devuelto

Comentarios

CMFCToolBarImages::GetMapTo3DColors

BOOL GetMapTo3DColors() const;

Valor devuelto

Comentarios

CMFCToolBarImages::GetMask

HBITMAP GetMask(int iImage);

Parámetros

[in] iImage

Valor devuelto

Comentarios

CMFCToolBarImages::GetResourceOffset

Devuelve el índice de imagen para un identificador de recurso especificado.

int GetResourceOffset(UINT uiResId) const;

Parámetros

uiResId
[in] Identificador de recurso de imagen.

Valor devuelto

Índice de imagen si el método se realizó correctamente; -1 si la imagen con el identificador de recurso especificado no existe.

CMFCToolBarImages::GetTransparentColor

COLORREF GetTransparentColor() const;

Valor devuelto

Comentarios

CMFCToolBarImages::GrayImages

Atenúa las imágenes de la barra de herramientas para que se vean deshabilitadas.

BOOL GrayImages(int nGrayImageLuminancePercentage);

Parámetros

nGrayImageLuminancePercentage
[in] Porcentaje de luminancia.

Valor devuelto

TRUE si las imágenes de la colección se han atenuado correctamente; en caso contrario, FALSE.

Comentarios

Este método modifica las imágenes de la barra de herramientas promediando los componentes rojo, verde y azul de cada píxel y multiplicando el resultado por nGrayImageLuminancePercentage dividido entre 100. Si nGrayImageLuminancePercentage es cero o negativo, se usa en su lugar el valor predeterminado de 130.

Nota:

Si desea deshacer el cambio, debe volver a cargar las imágenes desde el origen. Puede hacerlo llamando a CMFCToolBarImages::Load o CMFCToolBarImages::UpdateImage (solo para imágenes definidas por el usuario) o llamando a CMFCToolBarImages::Clear y agregando las imágenes de nuevo llamando a CMFCToolBarImages::AddIcon o CMFCToolBarImages::AddImage.

CMFCToolBarImages::Is32BitTransparencySupported

Especifica si el sistema operativo actual admite la combinación alfa de 32 bits.

static BOOL Is32BitTransparencySupported();

Valor devuelto

TRUE si se admite la combinación alfa de 32 bits; en caso contrario, FALSE.

Comentarios

Use este método estático para determinar en tiempo de ejecución si el sistema operativo admite la combinación alfa de 32 bits. Esta característica es compatible con Windows 2000 y versiones posteriores.

CMFCToolBarImages::IsPreMultiplyAutoCheck

BOOL IsPreMultiplyAutoCheck() const;

Valor devuelto

Comentarios

CMFCToolBarImages::IsReadOnly

Especifica si las imágenes de la barra de herramientas son de solo lectura.

BOOL IsReadOnly() const;

Valor devuelto

TRUE si las imágenes de la barra de herramientas son de solo lectura; de lo contrario, FALSE.

Comentarios

El objeto CMFCToolbarImages es de solo lectura cuando el mapa de bits con imágenes de la barra de herramientas se cargó desde un archivo de solo lectura o cuando el mapa de bits se copió mediante el método CMFCToolBarImages::CopyTemp.

CMFCToolBarImages::IsRTL

Especifica si la compatibilidad de derecha a izquierda (RTL) está habilitada.

static BOOL IsRTL();

Valor devuelto

TRUE si la compatibilidad con RTL está habilitada; en caso contrario, FALSE.

Comentarios

La compatibilidad con RTL se usa cuando la aplicación se localiza en un idioma que se lee de derecha a izquierda, como árabe, hebreo, persa o urdu.

CMFCToolBarImages::IsUserImagesList

Especifica si este conjunto de imágenes de la barra de herramientas contiene imágenes definidas por el usuario.

BOOL IsUserImagesList() const;

Valor devuelto

TRUE si el objeto CMFCToolBarImages contiene imágenes de la barra de herramientas definidas por el usuario; en caso contrario, FALSE.

CMFCToolBarImages::IsValid

Indica si este conjunto de imágenes de la barra de herramientas contiene una imagen válida de la barra de herramientas.

BOOL IsValid() const;

Valor devuelto

TRUE si un objeto CMFCToolBarImages es válido; de lo contrario, FALSE.

Comentarios

El objeto CMFCToolBarImages no es válido cuando su identificador para un mapa de bits con imágenes de la barra de herramientas es NULL.

CMFCToolBarImages::Load

Carga imágenes de la barra de herramientas desde los recursos del sistema o desde un archivo.

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

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

Parámetros

uiResID
[in] Identificador de un recurso de mapa de bits.

hinstRes
[in] Instancia del archivo DLL de recursos.

bAdd
[in] TRUE para agregar el mapa de bits cargado al mapa de bits existente o FALSE para reemplazar el mapa de bits existente.

lpszBmpFileName
[in] Ruta de acceso a un archivo de disco desde el que se va a cargar el mapa de bits.

nMaxFileSize
[in] Número máximo de bytes en el archivo de mapa de bits; o 0 para cargar el mapa de bits independientemente del tamaño del archivo. Si el tamaño del archivo supera este tamaño máximo, el método devuelve FALSE y no carga el mapa de bits.

Valor devuelto

TRUE si el mapa de bits se cargó correctamente; de lo contrario, FALSE.

Comentarios

Si el archivo tiene el atributo de solo lectura, la lista de imágenes se marca como de solo lectura.

CMFCToolBarImages::LoadStr

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

Parámetros

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

Valor devuelto

Comentarios

CMFCToolBarImages::MapFromSysColor

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

Parámetros

[in] color
[in] bUseRGBQUAD

Valor devuelto

Comentarios

CMFCToolBarImages::MapTo3dColors

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

Parámetros

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

Valor devuelto

Comentarios

CMFCToolBarImages::MapToSysColor

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

Parámetros

[in] color
[in] bUseRGBQUAD

Valor devuelto

Comentarios

CMFCToolBarImages::MapToSysColorAlpha

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

Parámetros

[in] color

Valor devuelto

Comentarios

CMFCToolBarImages::Mirror

Reemplaza las imágenes de la barra de herramientas por su imagen reflejada horizontal.

BOOL Mirror();

Valor devuelto

TRUE si las imágenes se han reflejado correctamente; en caso contrario, FALSE.

Comentarios

Este método se usa para admitir sistemas de escritura de derecha a izquierda.

CMFCToolBarImages::MirrorBitmap

Reemplaza un mapa de bits por su imagen reflejada horizontal.

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

Parámetros

hbmp
[in, out] Identificador del mapa de bits que se va a reflejar.

cxImage
[in] Ancho de la imagen en píxeles.

Valor devuelto

TRUE si las imágenes se han reflejado correctamente; en caso contrario, FALSE.

Comentarios

Esta función se usa para admitir sistemas de escritura de derecha a izquierda.

CMFCToolBarImages::MirrorBitmapVert

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

Parámetros

[in] hbmp
[in] cyImage

Valor devuelto

Comentarios

CMFCToolBarImages::MirrorVert

BOOL MirrorVert();

Valor devuelto

Comentarios

CMFCToolBarImages::OnSysColorChange

void OnSysColorChange();

Comentarios

CMFCToolBarImages::PreMultiplyAlpha

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

BOOL PreMultiplyAlpha(HBITMAP hbmp);

Parámetros

[in] hbmp
[in] bAutoCheckPremlt

Valor devuelto

Comentarios

CMFCToolBarImages::m_bDisableTrueColorAlpha

TRUE si la combinación alfa truecolor (color de 32 bits) está deshabilitada.

static BOOL m_bDisableTrueColorAlpha;

Comentarios

Establezca esta variable de miembro en FALSE para habilitar la combinación alfa truecolor para las imágenes de la barra de herramientas.

El valor predeterminado es TRUE para la compatibilidad con versiones anteriores.

CMFCToolBarImages::PrepareDrawImage

Asigna los recursos necesarios para dibujar una imagen de la barra de herramientas con un tamaño especificado.

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

Parámetros

ds
[in] Referencia a la estructura CAfxDrawState, que almacena los recursos asignados entre las fases de representación de imágenes.

sizeImageDest
[in] Especifica el tamaño de una imagen de destino.

bFadeInactive
[in] TRUE si desea que las imágenes inactivas se difuminen.

Valor devuelto

TRUE si los recursos necesarios para dibujar la imagen de la barra de herramientas se asignaron correctamente; de lo contrario, FALSE.

Comentarios

Después de llamar a este método, puede llamar a CMFCToolBarImages::Draw cualquier número de veces. Después de finalizar el dibujo, debe llamar a CMFCToolBarImages::EndDrawImage para liberar los recursos asignados por PrepareDrawImage.

CMFCToolBarImages::Save

Almacena las imágenes de la barra de herramientas en un archivo si este conjunto de imágenes de la barra de herramientas contiene imágenes definidas por el usuario.

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

Parámetros

lpszBmpFileName
Ruta de acceso a un archivo de disco.

Valor devuelto

TRUE si las imágenes de la barra de herramientas se guardaron correctamente; en caso contrario, FALSE.

Comentarios

Llame a este método para almacenar las imágenes definidas por el usuario en un archivo de disco. Si lpszBmpFileName es NULL, el método almacena el mapa de bits en el archivo desde el que el método CMFCToolBarImages::Load cargó el mapa de bits.

CMFCToolBarImages::SetAlwaysLight

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

Parámetros

[in] bAlwaysLight

Comentarios

CMFCToolBarImages::SetDisabledImageAlpha

Establece el valor del canal alfa (opacidad) que se usa para las imágenes deshabilitadas.

static void SetDisabledImageAlpha(BYTE nValue);

Parámetros

nValue
[in] Nuevo valor del canal alfa.

Comentarios

Use este método para establecer un valor alfa personalizado para las imágenes deshabilitadas. El valor predeterminado es 127, lo que hace que las imágenes de botón deshabilitadas sean semitransparentes. Si establece un valor de 0, las imágenes deshabilitadas serán completamente transparentes. Si establece un valor de 255, las imágenes deshabilitadas serán completamente opacas.

CMFCToolBarImages::SetFadedImageAlpha

static void __stdcall SetFadedImageAlpha(BYTE nValue);

Parámetros

[in] nValue

Comentarios

CMFCToolBarImages::SetImageSize

Establece el tamaño de cada imagen de la barra de herramientas (tamaño de origen).

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

Parámetros

sizeImage
[in] Nuevo tamaño de las imágenes de la barra de herramientas.

Comentarios

De forma predeterminada, el tamaño de la imagen de la barra de herramientas es de 16 x 15 píxeles. Llame a este método si desea usar imágenes de la barra de herramientas de un tamaño diferente.

CMFCToolBarImages::SetLightPercentage

void SetLightPercentage(int nValue);

Parámetros

[in] nValue

Comentarios

CMFCToolBarImages::SetMapTo3DColors

void SetMapTo3DColors(BOOL bMapTo3DColors);

Parámetros

[in] bMapTo3DColors

Comentarios

CMFCToolBarImages::SetPreMultiplyAutoCheck

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

Parámetros

[in] bAuto

Comentarios

CMFCToolBarImages::SetSingleImage

void SetSingleImage();

Comentarios

CMFCToolBarImages::SetTransparentColor

Establece el color transparente de las imágenes de la barra de herramientas.

COLORREF SetTransparentColor(COLORREF clrTransparent);

Parámetros

clrTransparent
[in] Valor RGB.

Valor devuelto

Color transparente anterior.

Comentarios

Cuando el usuario o el marco llaman a CMFCToolBarImages::Draw, el método no dibuja ningún píxel que coincida con el color especificado por clrTransparent.

CMFCToolBarImages::UpdateImage

Actualiza una imagen de la barra de herramientas definida por el usuario desde un mapa de bits.

BOOL UpdateImage(
    int iImage,
    HBITMAP hbmp);

Parámetros

iImage
[in] Índice de base cero de la imagen que se va a actualizar.

hbmp
[in] Identificador del mapa de bits desde el que se va a actualizar la imagen.

Valor devuelto

TRUE si la imagen se actualizó correctamente; FALSE si la lista de imágenes no está definida por el usuario ni es temporal.

CMFCToolBarImages::ConvertTo32Bits

Convierte los mapas de bits subrayados en imágenes de 32 bpp.

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

Parámetros

clrTransparent
Especifica el color transparente de los mapas de bits subrayados.

Comentarios

CMFCToolBarImages::GetBitsPerPixel

Devuelve la resolución actual de las imágenes subrayadas.

int GetBitsPerPixel() const;

Valor devuelto

Valor entero que representa la resolución actual de las imágenes subrayadas, en bits por píxel (bpp).

Comentarios

CMFCToolBarImages::GetScale

Devuelve la relación de escala actual de imágenes subrayadas.

double GetScale() const;

Valor devuelto

Valor que representa la relación de escala actual.

Comentarios

CMFCToolBarImages::IsScaled

Indica si las imágenes subrayadas se escalan o no.

BOOL IsScaled () const;

Valor devuelto

TRUE si se escalan las imágenes subrayadas; en caso contrario, FALSE.

Comentarios

CMFCToolBarImages::SmoothResize

Cambia ligeramente el tamaño de las imágenes subrayadas.

BOOL SmoothResize(double dblImageScale);

Parámetros

dblImageScale
Relación de escala.

Valor devuelto

TRUE si el cambio de tamaño se realiza correctamente; en caso contrario, FALSE.

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CObject (clase)
CMFCToolBar (clase)
CMFCToolBarButton (clase)

Compartir a través de

CMFCToolBarImages (clase)

Sintaxis

Miembros

Constructores públicos

Métodos públicos

Métodos protegidos

Miembros de datos

Comentarios

Ejemplo

Jerarquía de herencia

Requisitos

CMFCToolBarImages::AdaptColors

Parámetros

Comentarios

CMFCToolBarImages::AddIcon

Parámetros

Valor devuelto

CMFCToolBarImages::AddImage

Parámetros

Valor devuelto

CMFCToolBarImages::CleanUp

Comentarios

CMFCToolBarImages::Clear

CMFCToolBarImages::CMFCToolBarImages

Comentarios

CMFCToolBarImages::CopyImageToClipboard

Parámetros

Valor devuelto

Comentarios

CMFCToolBarImages::CopyTo

Parámetros

Valor devuelto

Comentarios

CMFCToolBarImages::CreateFromImageList

Parámetros

Valor devuelto

Comentarios

CMFCToolBarImages::CreateRegionFromImage

Parámetros

Valor devuelto

Comentarios

CMFCToolBarImages::DeleteImage

Parámetros

Valor devuelto

CMFCToolBarImages::Draw

Parámetros

Valor devuelto

CMFCToolBarImages::DrawEx

Parámetros

Valor devuelto

Comentarios

CMFCToolBarImages::EnableRTL

Parámetros

Comentarios

CMFCToolBarImages::EndDrawImage

Parámetros

CMFCToolBarImages::ExtractIcon

Parámetros

Valor devuelto

CMFCToolBarImages::FillDitheredRect

Parámetros

Comentarios

CMFCToolBarImages::GetAlwaysLight

Valor devuelto

Comentarios

CMFCToolBarImages::GetCount

Valor devuelto

CMFCToolBarImages::GetDisabledImageAlpha

Valor devuelto

Comentarios

CMFCToolBarImages::GetFadedImageAlpha

Valor devuelto

Comentarios

CMFCToolBarImages::GetImageSize

Parámetros

Valor devuelto

Comentarios

CMFCToolBarImages::GetImageWell

Valor devuelto