Clase wxImageList

Constructor por defecto.

Hay que tener en cuenta que el objeto creado utilizando el constructor por defecto no es válido y llamar a cualquier método que no sea Create() en él dará lugar a un fallo de aserción.

Constructor que especifica el tamaño de la imagen, si se deben crear máscaras de imagen y el tamaño inicial de la lista.

Hay que tener en cuenta que el tamaño se especifica en píxeles físicos y debe corresponder al tamaño de los mapas de bits, en píxeles, que se añadirán a esta lista.

Parámetros

width

Anchura de las imágenes de la lista.

height

Altura de las imágenes de la lista.

mask

Si es true, todas las imágenes tendrán máscaras, creándose la máscara a partir de los píxeles de color gris claro si no se especifica lo contrario, es decir, si la imagen no tiene ni canal alfa ni máscara y no se especifica explícitamente ninguna máscara al añadirla. Hay que tener en cuenta que si una imagen tiene canal alfa o máscara, siempre se utilizará, tanto si este parámetro es verdadero como falso.

initialCount

El tamaño inicial de la lista.

Añade una nueva imagen o imágenes utilizando un mapa de bits y un mapa de bits de máscara opcional.

El tamaño físico del mapa de bits debe ser el mismo que el especificado al construir wxImageList. Si la anchura del mapa de bits es mayor que la anchura de la lista de imágenes, el mapa de bits se divide en imágenes más pequeñas de la anchura requerida, lo que permite añadir varias imágenes a partir de un único mapa de bits.

Parámetros

bitmap

Mapa de bits que representa las áreas opacas de la imagen.

mask

Mapa de bits de máscara monocromática, que representa las áreas transparentes de la imagen.

Valor de retorno

El nuevo índice de la imagen basado en cero.

Añade una nueva imagen o imágenes utilizando un mapa de bits y un color de máscara.

El tamaño físico del mapa de bits debe ser el mismo que el especificado al construir wxImageList. Si la anchura del mapa de bits es mayor que la anchura de la lista de imágenes, el mapa de bits se divide en imágenes más pequeñas de la anchura requerida, lo que permite añadir varias imágenes a partir de un único mapa de bits.

Parámetros

bitmap

Mapa de bits que representa las áreas opacas de la imagen.

maskColour

Color que indica qué partes de la imagen son transparentes.

Valor de retorno

El nuevo índice de la imagen basado en cero.

Añade una nueva imagen utilizando un icono.

El tamaño físico del icono debe ser el mismo que el especificado al construir wxImageList.

Parámetros

icon

Icono a utilizar como imagen.

Valor de retorno

El nuevo índice de la imagen basado en cero.

Disponibilidad

Sólo disponible para los ports wxMSW, wxOSX/Cocoa.

Inicializa la lista.

Ver wxImageList() para más detalles.

Esta función puede ser llamada sólo una vez después de crear el objeto usando su constructor por defecto o después de llamar a Destroy().

Destruye la lista actual.

Esta función restablece el objeto a su estado inicial y hace más que RemoveAll() en la versión nativa wxMSW.

Después de llamarla, Create() puede ser llamada de nuevo para recrear la lista de imágenes, por ejemplo, usando un tamaño diferente.

Dibuja una imagen especificada en un contexto de dispositivo.

Parámetros

index

Índice de imagen, empezando por cero.

dc

Contexto de dispositivo sobre el que dibujar.

x

Posición X en el contexto de dispositivo.

y

Posición Y en el contexto de dispositivo.

flags

Cómo dibujar la imagen. Una lista de bits de una selección de los siguientes:

• wxIMAGELIST_DRAW_NORMAL: Dibuja la imagen normalmente.
• wxIMAGELIST_DRAW_TRANSPARENT: Dibuja la imagen con transparencia.
• wxIMAGELIST_DRAW_SELECTED: Dibuja la imagen en estado seleccionado.
• wxIMAGELIST_DRAW_FOCUSED: Dibuja la imagen en estado enfocado.

solidBackground

Para optimizar - el dibujo puede ser más rápido si se le dice a la función que el fondo es sólido.

Devuelve el mapa de bits correspondiente al índice dado.

Devuelve el icono correspondiente al índice dado.

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

Recupera el tamaño de la lista de imágenes tal y como se pasó a Create().

Valor de retorno

El tamaño de la lista de imágenes, que puede ser cero si la lista de imágenes aún no se ha inicializado.

Recupera el tamaño de las imágenes de la lista.

Actualmente, el parámetro index se ignora, ya que todas las imágenes de la lista tienen el mismo tamaño.

Parámetros

index

Actualmente sin usar, debería ser 0.

width

Recibe la anchura de las imágenes de la lista en píxeles.

height

Recibe la altura de las imágenes de la lista en píxeles.

Valor de retornox/h6>

true si la función ha tenido éxito, false si ha fallado (por ejemplo, si la lista de imágenes aún no se ha inicializado).

Elimina la imagen en la posición dada.

Elimina todas las imágenes de la lista.

Sustituye la imagen existente por la nueva imagen.

Parámetros

index

El índice del mapa de bits que se va a reemplazar.

bitmap

Mapa de bits que representa las áreas opacas de la imagen.

mask

Mapa de bits de máscara monocromática, que representa las áreas transparentes de la imagen.

Valor de retorno

true si la sustitución se ha realizado correctamente, false en caso contrario.

Observaciones

El bitmap o icono original no se ve afectado por la operación Replace(), y puede ser eliminado posteriormente.

Sustituye la imagen existente por la nueva imagen.

Parámetros

index

Índice del mapa de bits que se va a sustituir.

icon

Icono que se va a utilizar como imagen.

Valor de retorno

true si el reemplazo fue exitoso, false en caso contrario.

Observaciones

El mapa de bits o icono original no se ve afectado por la operación Replace(), y puede eliminarse posteriormente.

Disponibilidad

Sólo disponible para los ports wxMSW, wxOSX/Cocoa.