Пример "Flow Layout"Файлы:
Пример "Flow Layout" показывает создание своей компоновки, обеспечивающей вывод потомков слева направо и сверху вниз в виджете-предке. Элементы сначала располагаются по горизонтали, а затем - по вертикали, когда для строки в компоновщике не хватает места. Класс Flowlayout в основном использует QLayout и QWidgetItem, в то время как Window использует QWidget и QLabel. Мы приведём ниже только документацию определения и реализации FlowLayout. Определение класса FlowLayoutКласс FlowLayout унаследован от QLayout. Это класс пользовательского компоновщика, который выравнивает дочерние виджеты горизонтально и вертикально. class FlowLayout : public QLayout { public: FlowLayout(QWidget *parent, int margin = -1, int hSpacing = -1, int vSpacing = -1); FlowLayout(int margin = -1, int hSpacing = -1, int vSpacing = -1); ~FlowLayout(); void addItem(QLayoutItem *item); int horizontalSpacing() const; int verticalSpacing() const; Qt::Orientations expandingDirections() const; bool hasHeightForWidth() const; int heightForWidth(int) const; int count() const; QLayoutItem *itemAt(int index) const; QSize minimumSize() const; void setGeometry(const QRect &rect); QSize sizeHint() const; QLayoutItem *takeAt(int index); private: int doLayout(const QRect &rect, bool testOnly) const; int smartSpacing(QStyle::PixelMetric pm) const; QList<QLayoutItem *> itemList; int m_hSpace; int m_vSpace; }; Мы переопределяем функции, унаследованные от QLayout. Эти функции добавляют элементы к компоновщику и обрабатывают их ориентацию и геометрию. Мы также объявляем два закрытых метода, doLayout() и smartSpacing(). doLayout() компонует элементы компоновщика, а функция smartSpacing() вычисляет расстояние между ними. Реализация класса FlowLayoutМы начнём с рассмотрения конструктора: FlowLayout::FlowLayout(QWidget *parent, int margin, int hSpacing, int vSpacing) : QLayout(parent), m_hSpace(hSpacing), m_vSpace(vSpacing) { setContentsMargins(margin, margin, margin, margin); } FlowLayout::FlowLayout(int margin, int hSpacing, int vSpacing) : m_hSpace(hSpacing), m_vSpace(vSpacing) { setContentsMargins(margin, margin, margin, margin); } В конструкторе мы вызываем setContentsMargins() для установки левого, верхнего, правого и нижнего отступов. По умолчанию QLayout использует значения, предусмотренные текущим стилем (смотрите QStyle::PixelMetric). FlowLayout::~FlowLayout() { QLayoutItem *item; while ((item = takeAt(0))) delete item; } В этом примере мы переопределяем addItem(), которая является чисто виртуальной функцией. При использовании addItem() владение элементом компоновщика передаётся компоновщику, и поэтому компоновщик отвечает за их удаление. void FlowLayout::addItem(QLayoutItem *item) { itemList.append(item); } addItem() реализован для добавления элементов в компоновщик. int FlowLayout::horizontalSpacing() const { if (m_hSpace >= 0) { return m_hSpace; } else { return smartSpacing(QStyle::PM_LayoutHorizontalSpacing); } } int FlowLayout::verticalSpacing() const { if (m_vSpace >= 0) { return m_vSpace; } else { return smartSpacing(QStyle::PM_LayoutVerticalSpacing); } } Мы реализуем horizontalSpacing() и verticalSpacing() для получения расстояния между виджетами внутри компоновщика. Если значение меньше или равно 0, то будет использоваться это значение. Если нет, то будет вызвана smartSpacing() для вычисления расстояния. int FlowLayout::count() const { return itemList.size(); } QLayoutItem *FlowLayout::itemAt(int index) const { return itemList.value(index); } QLayoutItem *FlowLayout::takeAt(int index) { if (index >= 0 && index < itemList.size()) return itemList.takeAt(index); else return 0; } Затем мы реализуем count(), чтобы возвращает количество элементов в компоновщике. Для перемещения по списку мы используем itemAt(), а takeAt() - для удаления и возврата элементов из списка. Если элемент удалён, то оставшиеся элементы будут перенумерованы. Все три функции являются чисто виртуальными функциями из QLayout. Qt::Orientations FlowLayout::expandingDirections() const { return 0; } expandingDirections() возвращает направление Qt::Orientation, в котором компоновщик может использовать больше пространства, чем его sizeHint(). bool FlowLayout::hasHeightForWidth() const { return true; } int FlowLayout::heightForWidth(int width) const { int height = doLayout(QRect(0, 0, width, 0), true); return height; } Чтобы подстроиться под виджеты, у которых высота зависит от ширины, мы реализуем heightForWidth(). Функция hasHeightForWidth() используется для is проверки этой зависимости, а heightForWidth() передаёт ширину в doLayout(), которая в свою очередь использует ширину как параметр для прямоугольника компоновщика, т.е. ограничивающего прямоугольника, в котором размещаются элементы. Этот прямоугольник не включает в себя отступы margin() компоновщика. void FlowLayout::setGeometry(const QRect &rect) { QLayout::setGeometry(rect); doLayout(rect, false); } QSize FlowLayout::sizeHint() const { return minimumSize(); } QSize FlowLayout::minimumSize() const { QSize size; QLayoutItem *item; foreach (item, itemList) size = size.expandedTo(item->minimumSize()); size += QSize(2*margin(), 2*margin()); return size; } setGeometry() обычно используется для выполнения фактической компоновки, т.е. вычисления геометрии элементов компоновщика. В этом примере она вызывает doLayout() и передаёт прямоугольник компоновщика. sizeHint() предпочтительный размер компоновщика, а minimumSize() возвращает минимальный размер компоновщика. int FlowLayout::doLayout(const QRect &rect, bool testOnly) const { int left, top, right, bottom; getContentsMargins(&left, &top, &right, &bottom); QRect effectiveRect = rect.adjusted(+left, +top, -right, -bottom); int x = effectiveRect.x(); int y = effectiveRect.y(); int lineHeight = 0; doLayout() обрабатывает компоновку, если horizontalSpacing() или verticalSpacing() не возвращают значение по умолчанию. Она использует getContentsMargins() дял вычисления области, доступной для размещения элементов. QLayoutItem *item; foreach (item, itemList) { QWidget *wid = item->widget(); int spaceX = horizontalSpacing(); if (spaceX == -1) spaceX = wid->style()->layoutSpacing( QSizePolicy::PushButton, QSizePolicy::PushButton, Qt::Horizontal); int spaceY = verticalSpacing(); if (spaceY == -1) spaceY = wid->style()->layoutSpacing( QSizePolicy::PushButton, QSizePolicy::PushButton, Qt::Vertical); Затем она устанавливает необходимое расстояние для каждого виджета в компоновщике, основываясь на текущем стиле. int nextX = x + item->sizeHint().width() + spaceX; if (nextX - spaceX > effectiveRect.right() && lineHeight > 0) { x = effectiveRect.x(); y = y + lineHeight + spaceY; nextX = x + item->sizeHint().width() + spaceX; lineHeight = 0; } if (!testOnly) item->setGeometry(QRect(QPoint(x, y), item->sizeHint())); x = nextX; lineHeight = qMax(lineHeight, item->sizeHint().height()); } return y + lineHeight - rect.y() + bottom; } Положение каждого элемента в компоновщике вычисляется путём добавления ширины элемента и высоты линии к начальным координатам x и y. Это в свою очередь позволяет нам узнать, помещается ли следующий элемент в текущей строке или он должен быть перемещён вниз на следующую. Мы также определяем высоту текущей строки, основываясь на высотах виджетов. int FlowLayout::smartSpacing(QStyle::PixelMetric pm) const { QObject *parent = this->parent(); if (!parent) { return -1; } else if (parent->isWidgetType()) { QWidget *pw = static_cast<QWidget *>(parent); return pw->style()->pixelMetric(pm, 0, pw); } else { return static_cast<QLayout *>(parent)->spacing(); } } smartSpacing() предназначена для получения расстояния по умолчанию для каждого компоновщика верхнего уровня или подкомпоновщика. Расстояние по умолчанию для компоновщиков верхнего уровня, когда родителем является QWidget, будет определятся путём запроса к стилю. Расстояние по умолчанию для подкомпоновщиков, когда родителем является QLayout, будет определяться путём запроса расстояния у родительского компоновщика. |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |