QT(7)自定义Layout

时间:2022-11-01 04:19:16

QT(7)自定义Layout

我们进一步学习构建稍微复杂一点的布局。通过对抽象类QLayout的继承来进行自己的布局。在这个例子中,我们将重构QLayout类为BorderLayout,QLayout是一个用于布局管理的基础抽象类,而也是QBoxLayout,QGridLayout,QFormLayout和QStackedLayout的继承类。资料来源:

  1. http://doc.qt.nokia.com/latest/layouts-borderlayout.html
  2. http://www.kuqin.com/qtdocument/customlayout.html

一、搭建project的主题框架

我们创建自己的布局类为BorderLayout,使用borderlayout.cpp和borderlayout.h,构造我们的窗口mywindow.h和mywindow.cpp,以及主程序qtmain.cpp。下面是mywindows.cpp的内容,执行后如图所示。

MyWindow:: MyWindow()
{
    QTextBrowser * centralWidget = new QTextBrowser;
    centralWidget->setPlainText(tr("Central widget"));

    BorderLayout * layout = new BorderLayout;
    layout -> addWidget (centralWidget,BorderLayout::Center);
    layout -> addWidget (createLabel("North"),BorderLayout::North);
    layout -> addWidget (createLabel("West"),BorderLayout::West);
    layout -> addWidget (createLabel("East 1"),BorderLayout::East);
    layout -> addWidget (createLabel("East 2"),BorderLayout::East);
    layout -> addWidget (createLabel("South"),BorderLayout::South);
    setLayout(layout);
    setWindowTitle(tr("Border Layout"));
}

QLabel * MyWindow::createLabel(const QString &text)
{
    QLabel * label = new QLabel(text);
    label->setFrameStyle(QFrame::Box |QFrame::Raised);
    return label;
}

二、重点在建立我们的类BorderLayout,我们先建立一个用来存放被布局处理的项目的数据结构QList,每个entry为ItemWrapper,存放组件和位置信息。QLayout的抽象组件为QLayoutItem,实际可以是QLabel等等具体的组件。我们在borderlayout.h中定义:

private:
    struct ItemWrapper
    {
        ItemWrapper(QLayoutItem * i,Position p){
            item = i;
            position = p;
        }
        QLayoutItem * item;
        Position postion;
    };
    enum SizeType {MinumumSize, SizeHint};
    QSize calculateSize(SizeType sizeType) const; //用于后面
    QList list;

三、建立我们自己的布局管理器,需要实现QLayout中的几个virtual的函数。addItem(), sizeHint(), setGeometry(), itemAt() and takeAt(),此外还需要实现minimumSize()用于确保我们的布局没有因为space太小而重置为0。我们去查QLayout的参考(http://doc.qt.nokia.com/latest/qlayout.html),其中pure virtual的有:addItem(),intemAt(),takeAt(),count(),这些都是用于处理item的,分别是增加(存储),查找,删除,总数。我们同时在destory函数中清除所有item。

/********** borderlayout.h PART 2 ***********/
public:
    void addItem (QLayoutItem * item);
    QLayoutItem * itemAt(int index) const;
    QLayoutItem * takeAt(int index);
    int count() const;

    //在我们实际应用中,我们通常不使用addItem,而是使用addWidget,由于我们增加了一个方位因子,所以需要补充一个addWidget的方法。
    void addWidget(QWidget * w, Position p);

/********** borderlayout.cpp PART 2 ***********/
BorderLayout::~BorderLayout()
{
    QLayoutItem *l;
    while((l = takeAt(0)) != NULL)
        delete l;
}

//在我们存储的数据中加入元素,addItem在实际上是很少调用的,一般都会使用addWidget,它将使用addItem。
void BorderLayout :: addItem(QLayoutItem * item)
{
    list.append(new ItemWrapper(item,West));
}

//takeAt表示从list中删除index的item,并返回它,而index必须是有效的数值,因此需要先行检查:0 <= i < size()).
QLayoutItem * BorderLayout :: takeAt(int index)
{
    if(index >= 0 && index < list.size()){
        ItemWrapper * layoutStruct = list.takeAt(index);
        return layoutStruct -> item;
    }
    return 0;
}

QLayoutItem * BorderLayout :: itemAt(int index) const
{
    ItemWrapper * wrapper = list.value(index);
    if(wrapper)
        return wrapper->item;
    else
        return 0;
}

int BorderLayout::count() const
{
    return list.size();
}

void BorderLayout :: addWidget(QWidget * item, Position position)
{
    list.append(new ItemWrapper(new QWidgetItem (item),position));
}

四、编译:undefined reference to `BorderLayout::sizeHint() const QLayoutItem是QLayout操作的一个抽闲的item,有一些方法从QLayoutItem中继承,例如sizeHint表示implemented in subclasses to return the preferred size of this item,那么对于layout则表示整个layout的大小。而在QLayout中说明: sizeHint(), 此外通常还需要实现minimumSize(),我们一起补上,此外,我们还加上了expandingDirections(用于表明这个layout可以使用比sizeHint()更多的空间,并允许向那个维度扩展)

/************* borderlayout.cpp PART 3 ***************/
Qt::Orientations BorderLayout::expandingDirections() const
{
    return Qt::Vertical | Qt::Horizontal; //两个方向均允许扩展。
}

QSize BorderLayout :: sizeHint() const
{
    return calculateSize(MinimumSize);
}

QSize BorderLayout :: minimumSize() const
{
    return calculateSize(SizeHint);
}

//将各item的大小进行统计获得layout的大小
QSize BorderLayout::calculateSize(SizeType sizeType) const
{
    QSize totalSize;

    for(int i = 0 ; i < list.size(); i++){
        ItemWrapper * wrapper = list.at(i);
        Position position = wrapper -> position;
        QSize itemSize;

        if(sizeType == MinimumSize)
            itemSize = wrapper->item->minimumSize();
        else // SizeHint
            itemSize = wrapper->item->sizeHint();

        if(position == North || position == South || position == Center)
            totalSize.rheight() += itemSize.height();

        if(position == West || position == East || position == Center)
            totalSize.rwidth() += itemSize.width();
    }
    return totalSize;
}

五、setGeometry()是最重要的一个,用于描述这个布局,我们重造该方法:

void BorderLayout::setGeometry(const QRect &rect)
{
     QLayout::setGeometry(rect);
     /* Add you code here*/

在这里,我们向描述一下我们Layout的情况。

QT(7)自定义Layout

在这个图的基础上我们来布局。我们从QList中读出我们的组件,根据组件的位置属性,我们先完成南北向的组件布局,在完成东西向的组件布局,布局使用QRect来确定每个组件的大小,每个组件都有一个缺省的大小item->sizeHint().width()和item->sizeHint().height(),对于南北,宽度等同于整个layout,而东西,高度修正为同center的大小。明确了正阳的布局,我们编写下面的代码:

void BorderLayout::setGeometry(const QRect &rect)
{
   
ItemWrapper * center = NULL;
    int eastWidth = 0,westWidth = 0,northHeight = 0 ,southHeight = 0, centerHeight = 0;

    for(int i = 0; i < list.size(); i ++){
        ItemWrapper * wrapper = list.at(i);
        QLayoutItem * item = wrapper -> item;
        Position position = wrapper->position;
        if(position == North){
            item->setGeometry(QRect(rect.x(),northHeight, rect.width(),item->sizeHint().height()));
            northHeight += item->sizeHint().height() +spacing();
        }else if(position == South){
            item->setGeometry(QRect(rect.x(), rect.height()-southHeight-item->sizeHint().height(),
rect.width(), item->sizeHint().height()));
            southHeight += item->sizeHint().height() + spacing();
        }else if(position == Center){
            center = wrapper;
        }
    }

    centerHeight = rect.height()- northHeight-southHeight;
    for(int i = 0; i < list.size(); i ++){
        ItemWrapper * wrapper = list.at(i);
        QLayoutItem * item = wrapper -> item;
        Position position = wrapper->position;
        if(position == West){
            item->setGeometry(QRect(rect.x() + westWidth,northHeight,item->sizeHint().width(),centerHeight));
             westWidth += item->sizeHint().width()+spacing();
        }else if(position == East){
             item->setGeometry(QRect(rect.width()-eastWidth-item->sizeHint().width(),northHeight,
                                              item->sizeHint().width(),centerHeight));
             eastWidth += item->sizeHint().width() + spacing();
        }
    }
    if(center)
        center->item->setGeometry(QRect(westWidth,northHeight,
rect.width()-eastWidth-westWidth,centerHeight));
}

相关链接:我的MeeGo/Moblin相关文章

此外,看到这么一则小故事也copy下来:倒墙的前两年,东德一个名叫亨里奇的守墙卫兵,开枪射杀了攀爬柏林墙企图逃向西德的青年克利斯。1992年2月,在统一后的柏林法庭上,卫兵亨里奇受到审判。他的律师辩称,他们仅仅是执行命令的人,根本没有选择的权利,罪不在己。那么法官是怎么说怎么判的呢?法官当庭指出:“作为警察,不执行上级命令是有罪的,但是打不准是无罪的。作为一个心智健全的人,此时此刻,你有把枪口抬高一厘米的主权,这是你应主动承担的良心义务。这个世界,在法律之外还有‘良知’。当法律和良知冲突之时,良知是最高的行为准则,而不是法律。尊重生命,是一个放之四海而皆准的原则。”你有把枪口抬高一厘米的主权――在那个万不得已的情势下,打,但应该有意打不准 ――不把人家打死,这是最低限度的道德,这也是最高境界的良知。任何人都不能以“服从命令”为借口,去超越道德伦理的底线。 这就是“一厘米主权”的道德义务,否则就必须承担罪责。柏林法庭最终的判决是:判处开枪射杀克利斯的卫兵亨里奇三年半徒刑,不予假释。