/* * All or portions of this file Copyright (c) Amazon.com, Inc. or its affiliates or * its licensors. * * For complete copyright and license terms please see the LICENSE at the root of this * distribution (the "License"). All use of this software is governed by the License, * or, if provided, by the license below or the license accompanying this file. Do not * remove or modify any license notices. This file is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * */ #include "CardPage.h" #include #include #include #include #include #include #include #include #include #include #include static void addContentWidget(AzQtComponents::Card* card, int widgetHeight) { QWidget* testWidget = new QWidget(card); testWidget->setMaximumHeight(widgetHeight); testWidget->setMinimumHeight(widgetHeight); card->setContentWidget(testWidget); } CardPage::CardPage(QWidget* parent) : QWidget(parent) , ui(new Ui::CardPage) { ui->setupUi(this); QString exampleText = R"( A Card is a container widget that can be expanded and collapsed via an arrow in the title bar. The title bar is represented by a CardHeader object, which consists of an arrow button to expand/collapse, an icon, title text, a help button, a warning icon and a button to trigger the drop down menu.

Example:
#include <AzQtComponents/Components/Widgets/Card.h>
#include <AzQtComponents/Components/Widgets/CardHeader.h>
#include <AzQtComponents/Components/Widgets/CardNotification.h>

// To use a Card:
AzQtComponents::Card* card; // assume one is created, either in code or via a .ui file, done in Qt Designer

card->setTitle("Example Card");

QWidget* mainCardContentWidget = createContentWidget();
card->setContentWidget(mainCardContentWidget);

// Set a secondary content widget, for storing an extra set of options
card->setSecondaryTitle("Advanced Options");

QWidget* secondaryContentWidget = createSecondaryWidget();
card->setSecondaryContentWidget(secondaryContentWidget);

// Put an icon into the header
AzQtComponents::CardHeader* header = ui->functionalCard->header();
header->setIcon(QIcon(":/Cards/img/UI20/Cards/slice_item.png"));

// Set the help url to open in a browser if the user clicks the help button
header->setHelpURL("https://aws.amazon.com/documentation/lumberyard/");

// Clear the help url
header->clearHelpURL();

// Populate the menu that pops up when the header bar is right clicked or when the user clicks on the menu button
connect(card, &AzQtComponents::Card::contextMenuRequested, this, [](const QPoint& pos){
    QMenu menu;

    menu.addAction(new QAction("Example Menu Item"));
    
    menu.exec(point);
});

// Add a warning feature to the bottom of the Card, with a button to resolve it
AzQtComponents::CardNotification* notification = card->addNotification("Warning message!");
QPushButton* button = notification->addButtonFeature("Clear Warning");
connect(button, &QPushButton::clicked, card, &AzQtComponents::Card::clearNotifications);

// In most cases, you don't want to disable a Card.
// Instead, use this function to show the Card as disabled, but keep basic functionality
card->mockDisabledState(true);
)"; ui->exampleText->setHtml(exampleText); ui->basicCard->setTitle("Example Card"); addContentWidget(ui->basicCard, 30); ui->warningCard->setTitle("Card With Warning"); ui->warningCard->header()->setWarning(true); addContentWidget(ui->warningCard, 30); ui->disabledCard->setTitle("Actually Disabled Card"); ui->disabledCard->setContentWidget(new QWidget()); ui->disabledCard->header()->setIcon(QIcon(QStringLiteral(":/stylesheet/img/search.svg"))); ui->disabledCard->header()->setHelpURL("https://aws.amazon.com/documentation/lumberyard/"); ui->disabledCard->setSecondaryTitle("Secondary Title"); ui->disabledCard->setSecondaryContentWidget(new QWidget()); ui->disabledCard->setEnabled(false); ui->disabledCard2->setTitle("Mock Disabled Card"); ui->disabledCard2->setContentWidget(new QWidget()); ui->disabledCard2->header()->setIcon(QIcon(QStringLiteral(":/stylesheet/img/search.svg"))); ui->disabledCard2->header()->setHelpURL("https://aws.amazon.com/documentation/lumberyard/"); ui->disabledCard2->setSecondaryTitle("Secondary Title"); ui->disabledCard2->setSecondaryContentWidget(new QWidget()); ui->disabledCard2->mockDisabledState(true); ui->functionalCard->setTitle("Card With Secondary Section"); addContentWidget(ui->functionalCard, 60); // put in an example icon AzQtComponents::CardHeader* header = ui->functionalCard->header(); header->setIcon(QIcon(":/Cards/img/UI20/Cards/slice_item.png")); header->setHelpURL("https://aws.amazon.com/documentation/lumberyard/"); connect(ui->addButton, &QPushButton::clicked, this, &CardPage::addNotification); connect(ui->clearButton, &QPushButton::clicked, ui->functionalCard, &AzQtComponents::Card::clearNotifications); connect(ui->functionalCard, &AzQtComponents::Card::contextMenuRequested, this, &CardPage::showContextMenu); connect(ui->disabledCard, &AzQtComponents::Card::contextMenuRequested, this, &CardPage::showContextMenu); connect(ui->disabledCard2, &AzQtComponents::Card::contextMenuRequested, this, &CardPage::showContextMenu); m_addNotification = new QAction("Add Notification", this); addAction(m_addNotification); connect(m_addNotification, &QAction::triggered, this, &CardPage::addNotification); m_clearNotification = new QAction("Clear Notifications", this); addAction(m_clearNotification); connect(m_clearNotification, &QAction::triggered, ui->functionalCard, &AzQtComponents::Card::clearNotifications); m_warningAction = new QAction("Show Warning Icon", this); m_warningAction->setCheckable(true); addAction(m_warningAction); connect(m_warningAction, &QAction::toggled, this, &CardPage::toggleWarning); m_contentChangedAction = new QAction("Set content changed", this); m_contentChangedAction->setCheckable(true); connect(m_contentChangedAction, &QAction::toggled, this, &CardPage::toggleContentChanged); m_selectedChangedAction = new QAction("Toggle selected", this); m_selectedChangedAction->setCheckable(true); connect(m_selectedChangedAction, &QAction::toggled, this, &CardPage::toggleSelectedChanged); auto card = ui->functionalCard; card->setSecondaryTitle("Advanced Options"); QWidget* testWidget2 = new QWidget(card); testWidget2->setMaximumHeight(30); testWidget2->setMinimumHeight(30); card->setSecondaryContentWidget(testWidget2); } CardPage::~CardPage() { } void CardPage::addNotification() { AzQtComponents::CardNotification* notification = ui->functionalCard->addNotification("A warning message indicating a conflict or problem."); QPushButton* button = notification->addButtonFeature("Clear Warnings"); connect(button, &QPushButton::clicked, ui->functionalCard, &AzQtComponents::Card::clearNotifications); } void CardPage::toggleWarning(bool checked) { AzQtComponents::CardHeader* header = ui->functionalCard->header(); header->setWarning(checked); m_warningAction->setChecked(checked); } void CardPage::toggleContentChanged(bool changed) { AzQtComponents::CardHeader* header = ui->functionalCard->header(); header->setContentModified(changed); m_contentChangedAction->setChecked(changed); } void CardPage::toggleSelectedChanged(bool selected) { ui->functionalCard->setSelected(selected); m_selectedChangedAction->setChecked(selected); } void CardPage::showContextMenu(const QPoint& point) { QMenu menu; menu.addAction(m_addNotification); menu.addAction(m_clearNotification); menu.addSeparator(); menu.addAction(m_warningAction); menu.addAction(m_contentChangedAction); menu.addAction(m_selectedChangedAction); if (!menu.actions().empty()) { menu.exec(point); } }