定制图形控件说明

新控件的创建是通过继承已经存在的控件来得到的,一般控件继承Fl_Widget得到，组合控件继承Fl_Group得到

一个普通控件一般通过接收和显示一个值来与用户交互

一个组合控件包含一组子控件并处理子控件的移动，改变大小，显示或隐藏事件。Fl_Group是所有组合控件的基类，其他组合控件比如Fl_Pack, Fl_Scroll, Fl_Tabs , Fl_Tile,  Fl_Window都是他的子类

你也可以通过继承其他的已存在控件来得到你要的控件，通过提供不同的外观和接口。比如Button 控件都是 Fl_Button类的子类。他们的共同点是都是通过鼠标点击事件与用户交互。唯一不同的是按钮的外观。

如何开发一个控件的子类

你的子类可以直接继承Fl_Widget 类，也可以继承任何Fl_Widget类的子类。Fl_Widget只有四个虚拟函数，子类必须重载所有的或部分的这些函数。

构造函数

构造函数应该有以下参数

MyClass(int x, int y, int w, int h, const char *label = 0);

这就允许该类能很好的应用于FLUID中

这个构造函数必须调用基类的构造函数并传递相同的参数

MyClass::MyClass(int x, int y, int w, int h, const char *label)

: Fl_Widget(x, y, w, h, label) {

// do initialization stuff...

}

Fl_Widget的保护构造函数通过传递的参数x,y,w,h,label分别设置x(),y(),w(),h()和label()并初始化其他的属性如：

type(0);

box(FL_NO_BOX);

color(FL_BACKGROUND_COLOR);

selection_color(FL_BACKGROUND_COLOR);

labeltype(FL_NORMAL_LABEL);

labelstyle(FL_NORMAL_STYLE);

labelsize(FL_NORMAL_SIZE);

labelcolor(FL_FOREGROUND_COLOR);

align(FL_ALIGN_CENTER);

callback(default_callback,0);

flags(ACTIVE|VISIBLE);

image(0);

deimage(0);

Fl_Widget的保护成员函数

以下的成员函数是Fl_Widget提供给子类的：

Fl_Widget::clear_visible

Fl_Widget::damage

Fl_Widget::draw_box

Fl_Widget::draw_focus

Fl_Widget::draw_label

Fl_Widget::set_flag

Fl_Widget::set_visible

Fl_Widget::test_shortcut

Fl_Widget::type

void Fl_Widget::damage(uchar mask)
void Fl_Widget::damage(uchar mask, int x, int y, int w, int h)
uchar Fl_Widget::damage()

第一个函数是指对象的部分需要更新。参数mask中的位设置传递给damage().draw()函数能根据该值得到哪些需要重画。公共成员函数Fl_Widget::redraw()只是简单的做Fl_Widget::damage(FL_DAMAGE_ALL),即所有的都重画，但是你的控件真正执行的时候会调用私有成员函数damage(n).

第二个函数指某个区域无效，需要重画。

第三个函数返回所有damage(n)的调用所产生的位。

当重新画一个控件时，你应该先看看无效位，再决定你的控件的哪部分需要重新画。Handle()函数能够设置单独的无效位限制需要重画的数量。

MyClass::handle(int event) {

  ...

  if (change_to_part1) damage(1);

  if (change_to_part2) damage(2);

  if (change_to_part3) damage(4);

}

MyClass::draw() {

  if (damage() & FL_DAMAGE_ALL) {

    ... draw frame/box and other static stuff ...

  }

  if (damage() & (FL_DAMAGE_ALL | 1)) draw_part1();

  if (damage() & (FL_DAMAGE_ALL | 2)) draw_part2();

  if (damage() & (FL_DAMAGE_ALL | 4)) draw_part3();

}

void Fl_Widget::draw_box() const

第一个函数根据该控件的尺度画他的box().第二个函数根据box的类型b ,颜色c画box.

void Fl_Widget::draw_focus() const
void Fl_Widget::draw_focus(Fl_Boxtype b, int x, int y, int w, int h) const

在一个空间的限制box中画出焦点筐。第二个函数允许指定另一个不同box来画焦点

Fl_Widget::draw_label() const
void Fl_Widget::draw_label(int x, int y, int w, int h) const
void Fl_Widget::draw_label(int x, int y, int w, int h, Fl_Align align) const

Draw()函数调用该函数来画一个控件的label,如果标签出了该控件的box 范围，将不会被画出。

第二种形式自定义一个box来画标签，比如用于移动的滑块

第三种形式可以将标签画在任意的地方

void Fl_Widget::set_visible()
void Fl_Widget::clear_visible()

与Fl_Widget::show() Fl_Widget::hide()作用相同，但不发送FL_SHOW,FL_HIDE事件。

int Fl_Widget::test_shortcut() const
static int Fl_Widget::test_shortcut(const char *s)

uchar Fl_Widget::type() const
void Fl_Widget::type(uchar t)

返回一个8位的标示符，用于与Forms兼容，你也可以同于其他任何目的，设置的值应该小于100，以免与系统的保留值冲突

处理事件

虚拟函数int handle(int event)被用来处理任何发送给控件的事件.他能:

改变控件的状态

调用Fl_Widget::redraw()如果该控件需要重新显示

调用Fl_Widget::damage(n)当控件需要部分更新时(假如你在Fl_Widget::draw()函数中提供了对该函数的支持)

调用Fl_Widget::do_callback()如果一个回调函数产生时.

调用Fl_Widget::handle()对子控件

事件用一个整数来标识.最近事件产生的其他消息静态存储在本地,调用Fl::event_*()可以得到.

以下是一个利用handle()处理事件的例子，该控件的行为类似按钮同时接收x按键并调用回调函数

int MyClass::handle(int event) {

  switch(event) {

    case FL_PUSH:

      highlight = 1;

      redraw();

      return 1;

    case FL_DRAG: {

        int t = Fl::event_inside(this);

        if (t != highlight) {

          highlight = t;

         redraw();

       }

      }

      return 1;

    case FL_RELEASE:

      if (highlight) {

       highlight = 0;

       redraw();

        do_callback();

       // never do anything after a callback, as the callback

       // may delete the widget!

      }

      return 1;

    case FL_SHORTCUT:

      if (Fl::event_key() == 'x') {

        do_callback();

       return 1;

      }

      return 0;

    default:

      return Fl_Widget::handle(event);

  }

}

当你的handle()函数处理某事件后不能返回0，若是返回0，父控件将会把该事件发送给其他控件。

画控件

当FLTK需要重画控件时将调用虚拟函数draw().只有在damage()返回非0值时调用该函数，draw()返回后，damage()被清0。Draw()应该被声明为保护成员函数，避免在不需要写画图代码时用到。

Damage()将包含从最后一次调用draw()后damage(n)调用产生的所有与或位信息，根据该信息只重画需要重画的位置，只有FLTK认为需要全部重画时才打开FL_DAMAGE_ALL位，比如收到expose事件。

修改控件的尺寸

resize(int x,int y,int w,int h)在控件被移动和改变大小时被调用，这些参数分别是新位置，宽度和高度。但是x(),y(),w(),h(),还是以前的值，若要改变这些值，必须在基类中也调用resize()函数

不需要调用redraw()函数，至少只改变x(),y()时不需要，因为一个组合控件有一套更有效的方法来画新的位置

如何制作一个组合控件

一个组合控件包括一个或多个子控件。制作组合控件必须继承Fl_Group类.不继承Fl_Group类当然也可能可以制作一个组合控件，但是你还是要重新写Fl_Group类里面的工作

子控件可能在类里面声明

class MyClass : public Fl_Group {

  Fl_Button the_button;

  Fl_Slider the_slider;

  ...

};

构造函数要初始化这些子控件。他们将被自动的add()到group中。因为Fl_Group构造函数调用了begin().在构造函数中不要忘记调用end()函数

MyClass::MyClass(int x, int y, int w, int h) :

  Fl_Group(x, y, w, h),

  the_button(x + 5, y + 5, 100, 20),

  the_slider(x, y + 50, w, 20)

{

  ...(you could add dynamically created child widgets here)...

  end(); // don't forget to do this!

}