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_flashThumbnail 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_clicksJump list and recent documents
Explained in App icon.
appicon_taskappicon_set_tasksappicon_add_recentWindow proc hooks, Windows only
Explained in App icon.
appicon_releaseappicon_is_created_messageappicon_button_createdappicon_clickedExample
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);
}