Order Form Example▲

Image non disponible

DetailsDialog Definition▲

The DetailsDialog class is a subclass of QDialog, implementing a slot verify() to allow contents of the DetailsDialog to be verified later. This is further explained in DetailsDialog Implementation.

 
Sélectionnez
class DetailsDialog : public QDialog
{
    Q_OBJECT

public:
    DetailsDialog(const QString &title, QWidget *parent);

public slots:
    void verify();

public:
    QList<QPair<QString, int> > orderItems();
    QString senderName() const;
    QString senderAddress() const;
    bool sendOffers();

private:
    void setupItemsTable();

    QLabel *nameLabel;
    QLabel *addressLabel;
    QCheckBox *offersCheckBox;
    QLineEdit *nameEdit;
    QStringList items;
    QTableWidget *itemsTable;
    QTextEdit *addressEdit;
    QDialogButtonBox *buttonBox;
};

The constructor of DetailsDialog accepts parameters title and parent. The class defines four getter functions: orderItems(), senderName(), senderAddress(), and sendOffers() to allow data to be accessed externally.

The class definition includes input widgets for the required fields, nameEdit and addressEdit. Also, a QCheckBox and a QDialogButtonBox are defined; the former to provide the user with the option to receive information on products and offers, and the latter to ensure that buttons used are arranged according to the user's native platform. In addition, a QTableWidget, itemsTable, is used to hold order details.

The screenshot below shows the DetailsDialog we intend to create.

Image non disponible

DetailsDialog Implementation▲

The constructor of DetailsDialog instantiates the earlier defined fields and their respective labels. The label for offersCheckBox is set and the setupItemsTable() function is invoked to setup and populate itemsTable. The QDialogButtonBox object, buttonBox, is instantiated with OK and Cancel buttons. This buttonBox's accepted() and rejected() signals are connected to the verify() and reject() slots in DetailsDialog.

 
Sélectionnez
DetailsDialog::DetailsDialog(const QString &title, QWidget *parent)
    : QDialog(parent)
{
    nameLabel = new QLabel(tr("Name:"));
    addressLabel = new QLabel(tr("Address:"));
    addressLabel->setAlignment(Qt::AlignLeft | Qt::AlignTop);

    nameEdit = new QLineEdit;
    addressEdit = new QTextEdit;

    offersCheckBox = new QCheckBox(tr("Send information about products and "
                                      "special offers"));

    setupItemsTable();

    buttonBox = new QDialogButtonBox(QDialogButtonBox::Ok
                                     | QDialogButtonBox::Cancel);

    connect(buttonBox, &QDialogButtonBox::accepted, this, &DetailsDialog::verify);
    connect(buttonBox, &QDialogButtonBox::rejected, this, &DetailsDialog::reject);

A QGridLayout is used to place all the objects on the DetailsDialog.

 
Sélectionnez
    QGridLayout *mainLayout = new QGridLayout;
    mainLayout->addWidget(nameLabel, 0, 0);
    mainLayout->addWidget(nameEdit, 0, 1);
    mainLayout->addWidget(addressLabel, 1, 0);
    mainLayout->addWidget(addressEdit, 1, 1);
    mainLayout->addWidget(itemsTable, 0, 2, 2, 1);
    mainLayout->addWidget(offersCheckBox, 2, 1, 1, 2);
    mainLayout->addWidget(buttonBox, 3, 0, 1, 3);
    setLayout(mainLayout);

    setWindowTitle(title);
}

The setupItemsTable() function instantiates the QTableWidget object, itemsTable, and sets the number of rows based on the QStringList object, items, which holds the type of items ordered. The number of columns is set to 2, providing a "name" and "quantity" layout. A for loop is used to populate the itemsTable and the name item's flag is set to Qt::ItemIsEnabled or Qt::ItemIsSelectable. For demonstration purposes, the quantity item is set to a 1 and all items in the itemsTable have this value for quantity; but this can be modified by editing the contents of the cells at run time.

 
Sélectionnez
void DetailsDialog::setupItemsTable()
{
    items << tr("T-shirt") << tr("Badge") << tr("Reference book")
          << tr("Coffee cup");

    itemsTable = new QTableWidget(items.count(), 2);

    for (int row = 0; row < items.count(); ++row) {
        QTableWidgetItem *name = new QTableWidgetItem(items[row]);
        name->setFlags(Qt::ItemIsEnabled | Qt::ItemIsSelectable);
        itemsTable->setItem(row, 0, name);
        QTableWidgetItem *quantity = new QTableWidgetItem("1");
        itemsTable->setItem(row, 1, quantity);
    }
}

The orderItems() function extracts data from the itemsTable and returns it in the form of a QList<QPair<QString,int>> where each QPair corresponds to an item and the quantity ordered.

 
Sélectionnez
QList&lt;QPair&lt;QString, int&gt; &gt; DetailsDialog::orderItems()
{
    QList&lt;QPair&lt;QString, int&gt; &gt; orderList;

    for (int row = 0; row &lt; items.count(); ++row) {
        QPair&lt;QString, int&gt; item;
        item.first = itemsTable-&gt;item(row, 0)-&gt;text();
        int quantity = itemsTable-&gt;item(row, 1)-&gt;data(Qt::DisplayRole).toInt();
        item.second = qMax(0, quantity);
        orderList.append(item);
    }

    return orderList;
}

The senderName() function is used to return the value of the QLineEdit used to store the name field for the order form.

 
Sélectionnez
QString DetailsDialog::senderName() const
{
    return nameEdit-&gt;text();
}

The senderAddress() function is used to return the value of the QTextEdit containing the address for the order form.

 
Sélectionnez
QString DetailsDialog::senderAddress() const
{
    return addressEdit-&gt;toPlainText();
}

The sendOffers() function is used to return a true or false value that is used to determine if the customer in the order form wishes to receive more information on the company's offers and promotions.

 
Sélectionnez
bool DetailsDialog::sendOffers()
{
    return offersCheckBox-&gt;isChecked();
}

The verify() function is an additionally implemented slot used to verify the details entered by the user into the DetailsDialog. If the details entered are incomplete, a QMessageBox is displayed providing the user the option to discard the DetailsDialog. Otherwise, the details are accepted and the accept() function is invoked.

 
Sélectionnez
void DetailsDialog::verify()
{
    if (!nameEdit-&gt;text().isEmpty() &amp;&amp; !addressEdit-&gt;toPlainText().isEmpty()) {
        accept();
        return;
    }

    QMessageBox::StandardButton answer;
    answer = QMessageBox::warning(this, tr("Incomplete Form"),
        tr("The form does not contain all the necessary information.\n"
           "Do you want to discard it?"),
        QMessageBox::Yes | QMessageBox::No);

    if (answer == QMessageBox::Yes)
        reject();
}

MainWindow Definition▲

The MainWindow class is a subclass of QMainWindow, implementing two slots - openDialog() and printFile(). It also contains a private instance of QTabWidget, letters.

 
Sélectionnez
class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow();
    void createSample();

public slots:
    void openDialog();
    void printFile();

private:
    void createLetter(const QString &amp;name, const QString &amp;address,
                      QList&lt;QPair&lt;QString,int&gt; &gt; orderItems,
                      bool sendOffers);

    QAction *printAction;
    QTabWidget *letters;
};

MainWindow Implementation▲

The MainWindow constructor sets up the fileMenu and the required actions, newAction and printAction. These actions' triggered() signals are connected to the additionally implemented openDialog() slot and the default close() slot. The QTabWidget, letters, is instantiated and set as the window's central widget.

 
Sélectionnez
MainWindow::MainWindow()
{
    QMenu *fileMenu = new QMenu(tr("&amp;File"), this);
    QAction *newAction = fileMenu-&gt;addAction(tr("&amp;New..."));
    newAction-&gt;setShortcuts(QKeySequence::New);
    printAction = fileMenu-&gt;addAction(tr("&amp;Print..."), this, &amp;MainWindow::printFile);
    printAction-&gt;setShortcuts(QKeySequence::Print);
    printAction-&gt;setEnabled(false);
    QAction *quitAction = fileMenu-&gt;addAction(tr("E&amp;xit"));
    quitAction-&gt;setShortcuts(QKeySequence::Quit);
    menuBar()-&gt;addMenu(fileMenu);

    letters = new QTabWidget;

    connect(newAction, &amp;QAction::triggered, this, &amp;MainWindow::openDialog);
    connect(quitAction, &amp;QAction::triggered, this, &amp;MainWindow::close);

    setCentralWidget(letters);
    setWindowTitle(tr("Order Form"));
}

The createLetter() function creates a new QTabWidget with a QTextEdit, editor, as the parent. This function accepts four parameters that correspond to we obtained through DetailsDialog, in order to "fill" the editor.

 
Sélectionnez
void MainWindow::createLetter(const QString &amp;name, const QString &amp;address,
                              QList&lt;QPair&lt;QString,int&gt; &gt; orderItems,
                              bool sendOffers)
{
    QTextEdit *editor = new QTextEdit;
    int tabIndex = letters-&gt;addTab(editor, name);
    letters-&gt;setCurrentIndex(tabIndex);

We then obtain the cursor for the editor using QTextEdit::textCursor(). The cursor is then moved to the start of the document using QTextCursor::Start.

 
Sélectionnez
    QTextCursor cursor(editor-&gt;textCursor());
    cursor.movePosition(QTextCursor::Start);

Recall the structure of a Rich Text Document, where sequences of frames and tables are always separated by text blocks, some of which may contain no information.

In the case of the Order Form Example, the document structure for this portion is described by the table below:

frame with referenceFrameFormat

block

A company

block

block

321 City Street

block

block

Industry Park

block

block

Another country

This is accomplished with the following code:

 
Sélectionnez
    QTextFrame *topFrame = cursor.currentFrame();
    QTextFrameFormat topFrameFormat = topFrame-&gt;frameFormat();
    topFrameFormat.setPadding(16);
    topFrame-&gt;setFrameFormat(topFrameFormat);

    QTextCharFormat textFormat;
    QTextCharFormat boldFormat;
    boldFormat.setFontWeight(QFont::Bold);

    QTextFrameFormat referenceFrameFormat;
    referenceFrameFormat.setBorder(1);
    referenceFrameFormat.setPadding(8);
    referenceFrameFormat.setPosition(