Dialog Namespace

The library's own windows, and how to restyle them. C++ only. In JavaScript and Python, draw your own form and call the same functions.

Auth dialogs

The auth-flow dialogs live in Atlas::License::Dialog:: and Atlas::Account::Dialog::. Documented at License and Account.

FatalError

FatalErrorvoid FatalError(const std::string& title, const std::string& body, const std::string& error_code = "");

Atlas.h:212

Unrecoverable-error dialog with a Copy Details button. Informational only - does not terminate the process.

Parameters

Name	Type	Description
`title`	`string`	Dialog title.
`body`	`string`	Body text.
`error_code`optional	`string`	Shown in the copy details payload.

C++

Atlas::Dialog::FatalError(
    "Atlas - fatal error",
    "The Atlas runtime failed to initialise. See Dashboard → Logs for the server-side reason.",
    "ATLAS-INIT-001");

Theme

C++

// Switch the dialog theme. Dark is the default and matches the Atlas dashboard.
Atlas::Dialog::theme = Atlas::Dialog::Theme::Light;
 
// Shown in every dialog title bar.
Atlas::Dialog::AppName = "MyApp";
 
// Modal parent. nullptr = foreground window.
Atlas::Dialog::parent = hMainWnd;

Globals

Field	Type	Description	Populated when
`AppName`	`string`	Shown in every dialog title bar. Default `"Atlas"`.	always
`theme`	`Theme`	Dark (default, matches the dashboard) or Light.	always
`parent`	`HWND`	Modal parent. `nullptr` = foreground window.	always

Theme enum

Theme::Dark	C++ `Theme::Dark`	Default. Matches the Atlas dashboard.
Theme::Light	C++ `Theme::Light`	Light dialog surfaces.

Accents

Per-channel colour overrides. Set fields to non-zero to override; leave at 0 to keep the theme default. Colour format is 0xAARRGGBB (alpha ignored).

C++

// 0xAARRGGBB. Alpha ignored. Fields at 0 keep the theme default.
// Setting 'panel' also auto-derives raised/raisedHover/lineSoft.
Atlas::Dialog::accents.signal = 0xFFE04A2C;   // orange primary CTA
Atlas::Dialog::accents.panel  = 0xFF0E1B2E;   // dialog surface
Atlas::Dialog::accents.ok     = 0xFF22C55E;   // success / verified

Accents fields

Field	Type	Description	Populated when
`signal`	`unsigned int`	Primary CTA + focus rings.	—
`panel`	`unsigned int`	Dialog surface. Setting this also auto-derives `raised`, `raisedHover`, and `lineSoft` so the override stays coherent.	—
`ink`	`unsigned int`	Caption bar / dark backing.	—
`hi_text`	`unsigned int`	Primary text.	—
`lo_text`	`unsigned int`	Secondary text.	—
`faint_text`	`unsigned int`	Labels / hints.	—
`line`	`unsigned int`	Hairline borders.	—
`alert`	`unsigned int`	Errors + destructive.	—
`ok`	`unsigned int`	Success + verified.	—

Title

AppName is the text in every window's title bar. AppDialogTitle replaces the heading of the email-code window. "" keeps the built-in heading. The other text in the windows is fixed.

C++

// "" keeps the built-in heading ("Check your email" and "Confirm your email").
Atlas::Dialog::AppDialogTitle = "Enter the code we emailed";

Was this page useful?