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的情况。

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