Пример "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, будет определяться путём запроса расстояния у родительского компоновщика.
Авторские права © 2010 Nokia Corporation и/или её дочерние компании |
Торговые марки |
Qt 4.6.4 |
|