QtCraft API C++ classes QML types Handbook

QcScreenChoice Class

Picks the screen a scripted run opens its window on (–screen / QTCRAFT_SCREEN) and places the window fully inside it. More...

Header: #include <clientcore/settings/QcScreenChoice.h>

Public Types

struct Result
struct Screen

Static Public Members

std::optional<QcScreenChoice::Result> choose(const QList<QcScreenChoice::Screen> &screens, const QString &request)
QRect placeInside(QRect available, QSize size)

Detailed Description

Pure logic over screen descriptions, so it is testable without displays.

Member Function Documentation

[static] std::optional<QcScreenChoice::Result> QcScreenChoice::choose(const QList<QcScreenChoice::Screen> &screens, const QString &request)

request: "builtin" (the built-in panel; else a screen whose name says "built-in"; else the primary screen), a screen index ("0", "1", ...) or a name (exact, else contained, ignoring case; else the primary screen). Returns the screen chosen among screens; std::nullopt for an empty request or no screens.

[static] QRect QcScreenChoice::placeInside(QRect available, QSize size)

Returns a window of size centred on available, shrunk to fit inside it.