15.1.462. tablet_qt/questionnairelib/qugridcell.h

/*
    Copyright (C) 2012, University of Cambridge, Department of Psychiatry.
    Created by Rudolf Cardinal (rnc1001@cam.ac.uk).

    This file is part of CamCOPS.

    CamCOPS is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    CamCOPS is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with CamCOPS. If not, see <https://www.gnu.org/licenses/>.
*/

#pragma once
#include "questionnairelib/quelement.h"

class QuGridCell
{
    // Encapsulates a grid cell containing a QuElement.
    // Used by QuContainerGrid.

public:
    // Default constructor, so it can live in a QVector
    QuGridCell();

    // Construct with data
    QuGridCell(
        const QuElementPtr& element,
        int row,  // y position, starting from 0, going down
        int column,  // x position, starting from 0, going right
        int row_span = 1,  // height
        int column_span = 1,  // width
        Qt::Alignment alignment = Qt::Alignment(),
        bool override_element_alignment = true
    );
    QuGridCell(
        QuElement* element,  // takes ownership
        int row,
        int column,
        int row_span = 1,
        int column_span = 1,
        Qt::Alignment alignment = Qt::Alignment(),
        bool override_element_alignment = true
    );

public:
    QuElementPtr element;  // the element
    int row;  // zero-based row index
    int column;  // zero-based column index
    int row_span;  // height in rows
    int column_span;  // width in columns
    bool override_element_alignment;  // override widget's own alignment?
    Qt::Alignment alignment;
    // ... alignment to apply to element in this cell, if
    // override_element_alignment is true;
    // see https://doc.qt.io/qt-6.5/qgridlayout.html

public:
    // Debug description
    friend QDebug operator<<(QDebug debug, const QuGridCell& plan);
};