OSTaskbarManager

SetBadge

Variante de sintaxis: PorImagen

Sintaxis:

SetBadge(<Imagen>, <OcultarAlSeleccionar>)

Parámetros:

Tipo: Imagen.
Un icono que se mostrará en la esquina inferior derecha del botón del programa en la barra de tareas.
Formato de imagen: cualquier formato, pero se recomienda el formato “.ico”, tamaño de imagen: 16×16 píxeles (se recomienda tener imágenes para tamaños de imagen de 20×20 y 24×24 píxeles).

Tipo: Booleano.
Si esta propiedad se establece en Verdadero, al hacer clic en el botón de la aplicación en la barra de tareas o cualquier otra operación que active la ventana de la aplicación (por ejemplo, activación automática al abrir un formulario) se eliminará el icono.
Valor predeterminado: Falso.

Descripción de la variante del método:

Establece un icono a partir de la imagen.

Variante de sintaxis: PorNúmero

Sintaxis:

SetBadge(<Número>, <OcultarAlSeleccionar>)

Parámetros:

Tipo: Número.
Un número (de 0 a 99) que se mostrará en la esquina inferior derecha del botón del programa en la barra de tareas.

Tipo: Booleano.
Si esta propiedad se establece en Verdadero, al hacer clic en el botón de la aplicación en la barra de tareas o cualquier otra operación que active la ventana de la aplicación (por ejemplo, activación automática al abrir un formulario) se eliminará el icono.
En el sistema operativo Unity OS, el parámetro se ignora.
Valor predeterminado: Falso.

Descripción:

Especifica una insignia de notificación en la parte superior del botón del programa en la barra de tareas.
Funciona en Windows 7 o superior, Ubuntu Unity. No realiza ninguna acción en otros sistemas operativos.

Disponibilidad:

Cliente ligero, cliente pesado.

Nota:

La opción de usar una imagen como icono de notificación solo funciona en Windows 7 y superior.
Las insignias en los botones de aplicación en la barra de tareas de Windows solo se muestran si la opción “Usar iconos pequeños” está desactivada y “Iconos grandes” en las propiedades del menú Inicio está marcada.
El número que se especifica como icono de notificación en Windows 7 o superior debe pertenecer al rango [0, 99], en Ubuntu Unity – [0, 9999]; de lo contrario, se reemplazará por un valor límite relevante.
En el sistema operativo Unity OS, se ignora el parámetro &HideWhenSelecting.

Ejemplo:

Disponible desde:

Disponible desde la versión 8.3.8.