设计Qt风格的C++的应用程序接口

pugs

原帖请见，这里仅引用我最认同的部分。
http://www.cppblog.com/len/archive/2008/05/11/49563.aspx

方便性陷阱
通常的误读是越少的代码越能使你达到编写更好的API这一目的.请记住，代码只写一遍，却要一遍又一遍地去理解阅读它.比如:

1. 
   
2. QSlider *slider = new QSlider(12, 18, 3, 13, Qt::Vertical, 0, "volume");
   

复制代码

可以会比下面的代码更难阅读(甚至于编写)

1. 
   
2. QSlider *slider = new QSlider(Qt::Vertical);
   
3. slider->setRange(12, 18);
   
4. slider->setPageStep(3);
   
5. slider->setValue(13);
   
6. slider->setObjectName("volume");
   

复制代码

布尔参数陷阱
布尔参数常常导致难以阅读的代码.特别地，增加某个bool参数到现存的函数一般都会是个错误的决定．在Qt中，传统的例子是repaint(),它带有一个可选的布尔参数，来指定背景是否删除(默认是删除)．这就导致了代码会像这样子:

1. 
   
2. widget->repaint(false);
   

复制代码

初学者可能会按字面义理解为,"不要重绘!"

自然的想法是bool参数节省了一个函数,因此减少了代码的臃肿.事实上,这增加了代码的臃肿，有多少Qt用户真正知道下面这三行代码在做什么呢？

1. 
   
2. widget->repaint();
   
3. widget->repaint(true);
   
4. widget->repaint(false);
   

复制代码

好一点的API代码可能看起来像这样：

1. 
   
2. widget->repaint();
   
3. widget->repaintWithoutErasing();
   

复制代码

pugs

wxWidgets恰好使用了Qt反对的风格，下面是wxSlider构造函数的原型：

1. 
   
2. wxSlider(wxWindow* parent,
   
3.               wxWindowID id,
   
4.               int value ,
   
5.               int minValue,
   
6.               int maxValue,
   
7.               const wxPoint& point = wxDefaultPosition,
   
8.               const wxSize& size = wxDefaultSize,
   
9.               long style = wxSL_HORIZONTAL,
   
10.               const wxValidator& validator = wxDefaultValidator,
    
11.               const wxString& name = "slider");
    

复制代码

调用wxSlider的一个例子：

1. 
   
2. slider = new wxSlider(panel, -1, 1 , 1, 100, wxPoint(100, 100));
   

复制代码

大家可以对照上面的QSlider体会一下：

1. 
   
2. QSlider *slider = new QSlider(Qt::Vertical);
   
3. slider->setRange(12, 18);
   
4. slider->setPageStep(3);
   
5. slider->setValue(13);
   
6. slider->setObjectName("volume");
   

复制代码

[ 本帖最后由 pugs 于 2008-12-29 20:42 编辑 ]