Skip to main content

Toggle

A checkable button with default and outline variants and size choices.

Loading preview…
#include <QApplication>
#include <QFile>
#include <QHBoxLayout>
#include <QLabel>
#include <QPainter>
#include <QStandardItemModel>
#include <QUrl>
#include <QVBoxLayout>
#include <array>
#ifdef SHADCN_GALLERY_MEDIA
#include <shadcn/media.hpp>
#endif
#include <shadcn/shadcn.hpp>

QWidget* example(QWidget* parent = nullptr) {
using namespace shadcn;
auto* canvas = new QWidget(parent);
canvas->setAutoFillBackground(true);
auto* outer = new QHBoxLayout(canvas);
outer->setContentsMargins(32, 32, 32, 32);
auto* host = new QWidget(canvas);
auto* layout = new QVBoxLayout(host);
layout->setContentsMargins(0, 0, 0, 0);
layout->setSpacing(16);
outer->addStretch();
outer->addWidget(host, 0, Qt::AlignCenter);
outer->addStretch();
auto* toggle = new Toggle("B", host);
toggle->setVariant(ToggleVariant::Outline);
toggle->setAccessibleName("Bold");
auto font = toggle->font();
font.setBold(true);
toggle->setFont(font);
toggle->setChecked(true);
layout->addWidget(toggle);
return canvas;
}

Installation​

add_subdirectory(shadcn-cpp)
target_link_libraries(app PRIVATE shadcn::widgets)

Usage​

#include <shadcn/controls.hpp>

shadcn::Toggle toggle("Preview", parent);
toggle.setVariant(shadcn::ToggleVariant::Outline);
toggle.setToggleSize(shadcn::ToggleSize::Sm);
toggle.setChecked(true);

API​

setVariant, setToggleSize, setInvalid and inherited check state define the control.

Variations​

Use default or outline variants and default, small or large sizes.

Keyboard and accessibility​

Qt supplies native focus, keyboard interaction and accessible object roles. Give the component a visible label or an accessible name when its text alone does not explain the action.

Ownership​

The parent widget owns the component. Child widgets created through a component layout follow Qt parent ownership. References returned by helper methods are borrowed.