On this page

appicon.h

The app icon, the taskbar button on Windows and the Dock tile on mac. A feature one side lacks returns false or does nothing and logs once.

#include "isolenui/platform/appicon.h". The guide starts at App icon.

Progress, badge and attention

Explained in App icon.

appicon_progressappicon_progress_noneappicon_progress_normalappicon_progress_indeterminateappicon_progress_pausedappicon_progress_errorappicon_set_progressappicon_set_overlayappicon_flash

Thumbnail toolbar

Explained in App icon.

appicon_buttonAPPICON_MAX_BUTTONSAPPICON_BUTTON_DISABLEDAPPICON_BUTTON_DISMISSAPPICON_BUTTON_HIDDENAPPICON_BUTTON_NO_BACKGROUNDAPPICON_BUTTON_NON_INTERACTIVEappicon_set_buttonsappicon_take_clicksappicon_has_clicks

Jump list and recent documents

Explained in App icon.

appicon_taskappicon_set_tasksappicon_add_recent

Window proc hooks, Windows only

Explained in App icon.

appicon_releaseappicon_is_created_messageappicon_button_createdappicon_clicked

Example

appicon_shell.cpp
#include "isolenui/platform/appicon.h"

#include <stdint.h>

// jump list tasks live with the shell, not a window, so they outlast the process
void register_tasks(void)
{
    const appicon_task tasks[] = {
        { "New deck", "open an empty deck", nullptr, "--new", nullptr, 0 },
        { "Rehearse", "start the last deck in rehearsal mode", nullptr, "--rehearse", nullptr, 0 },
    };
    appicon_set_tasks(tasks, 2);
}

void clear_tasks(void)
{
    appicon_set_tasks(nullptr, 0);
}

void opened(const char* path)
{
    appicon_add_recent(path);
}

void show_unread(window* w, const uint8_t* badge_rgba, uint32_t count)
{
    if (count) {
        appicon_set_overlay(w, badge_rgba, 16, "unread messages");
    } else {
        appicon_set_overlay(w, nullptr, 0, nullptr);
    }
}

void job_failed(window* w, float fraction)
{
    // error keeps the fraction, flash stops by itself once the window takes the focus
    appicon_set_progress(w, appicon_progress_error, fraction);
    appicon_flash(w, true);
}

Last updated 23 October 2026