颜色选择 - GTK+ 2.0 中文教程

颜色选择 Color Selection
示例
效果
源码

颜色选择 Color Selection

颜色选择(color selection)控件是一个用来交互式地选择颜色的控件。这个组合控件让用户通过操纵RGB值(红绿蓝)和HSV值(色度、饱和度、纯度)来选择颜色。这是通过调整滑动条(sliders)的值或者文本输入控件的值，或者从一个色度/饱和度/纯度条上选择相应的颜色来实现的。你还可以通过它来设置颜色的透明性。

目前，颜色选择控件只能引发一种信号： color_changed。它是在控件你的颜色值发生变化时，或者通过 gtk_color_selection_set_color() 函数显式设置控件的颜色值时引发。

现在可以看一下颜色选择控件能够为我们提供一些什么。这个控件有两种风格：GtkColorSelection 和 GtkColorSelectionDialog。

GtkWidget *gtk_color_selection_new( void );

你将很少直接使用这个函数。它创建一个孤立的颜色选择控件，并需要将其放在某个窗口上。颜色选择控件是从VBox控件派生的。

GtkWidget *gtk_color_selection_dialog_new( const gchar *title );

这是最常用的颜色选择控件的构建函数，它创建一个颜色选择对话框。它内部有一个框架控件，框架控件中包含了一个颜色选择控件、一个垂直分隔线控件、一个包含了Ok、Cancel、Help三个按钮的横向盒。你可以通过访问颜色选择对话框控件结构中的”ok_button”, “cancel_button”和”help_button”控件来访问它们(例如：GTK_COLOR_SELECTION_DIALOG (colorseldialog)->ok_button))。

void gtk_color_selection_set_has_opacity_control( GtkColorSelection *colorsel,
                                                  gboolean           has_opacity );

颜色选择控件支持调整颜色的不透明性(一般也称为alpha通道)。缺省值是禁用这个特性。调用下面的函数，将has_opacity设置为TRUE启用该特性。同样，has_opacity 设置为 FALSE 时将禁用此特性。

void gtk_color_selection_set_current_color( GtkColorSelection *colorsel,
                                            GdkColor          *color );

void gtk_color_selection_set_current_alpha( GtkColorSelection *colorsel,
                                            guint16            alpha );

可以调用 gtk_color_selection_set_current_color() 函数显式地设置颜色选择控件的当前颜色，其中的color参数是一个指向GdkColor的指针。gtk_color_selection_set_current_alpha()用来设置不透明度(alpha通道)。其中的alpha值应该在0(完全透明)和65636(完全不透明)之间。

void gtk_color_selection_get_current_color( GtkColorSelection *colorsel,
                                        GdkColor *color );

void gtk_color_selection_get_current_alpha( GtkColorSelection *colorsel,
                                            guint16           *alpha );

当需要查询当前颜色值时，典型情况是接收到一个 “color_changed” 信号时，使用这些函数。

示例

效果

颜色选择 - 图1

源码

下面是一个简单的示例，它演示了如何使用颜色选择对话框控件。这个程序显示了一个包含绘图区的窗口。点击它会打开一个颜色选择对话框，改变颜色选择对话框中的颜色，会改变绘图区的背景色。

#include <glib.h>
#include <gdk/gdk.h>
#include <gtk/gtk.h>

GtkWidget *colorseldlg = NULL;
GtkWidget *drawingarea = NULL;
GdkColor color;

/* 颜色改变信号的处理函数 */
void color_changed_cb( GtkWidget         *widget,
                       GtkColorSelection *colorsel )
{
    GdkColor ncolor;

    gtk_color_selection_get_current_color (colorsel, &ncolor);
    gtk_widget_modify_bg (drawingarea, GTK_STATE_NORMAL, &ncolor);       
}

/* 绘图区事件处理函数 */
gint area_event( GtkWidget *widget,
                 GdkEvent  *event,
                 gpointer   client_data )
{
    gint handled = FALSE;
    gint response;
    GtkColorSelection *colorsel;

    /* 检查是否接收到一个鼠标按键按下事件 */
    if (event->type == GDK_BUTTON_PRESS)
    {
        handled = TRUE;

        /* 创建颜色选择对话框 */
        if (colorseldlg == NULL)
        {
            colorseldlg = gtk_color_selection_dialog_new ("Select background color");
        }

        /* 获取颜色选择控件 */
        colorsel = GTK_COLOR_SELECTION (GTK_COLOR_SELECTION_DIALOG (colorseldlg)->colorsel);

        gtk_color_selection_set_previous_color (colorsel, &color);
        gtk_color_selection_set_current_color (colorsel, &color);
        gtk_color_selection_set_has_palette (colorsel, TRUE);

        /* 为 "color_changed" 信号设置回调函数，将用户数据设置为
        * 颜色选择控件 */
        g_signal_connect (G_OBJECT (colorsel), "color_changed",
        G_CALLBACK (color_changed_cb), (gpointer)colorsel);

        /* 显示对话框 */
        response = gtk_dialog_run (GTK_DIALOG (colorseldlg));

        if (response == GTK_RESPONSE_OK)
        {
            gtk_color_selection_get_current_color (colorsel, &color);
        }
        else 
        {
            gtk_widget_modify_bg (drawingarea, GTK_STATE_NORMAL, &color);
        }

        gtk_widget_hide (colorseldlg);
    }

    return handled;
}

/* 关闭、退出的事件处理函数 */
gint destroy_window( GtkWidget *widget,
                     GdkEvent  *event,
                     gpointer   client_data )
{
  gtk_main_quit ();

  return TRUE;
}

/* 主函数 */
gint main( gint   argc,
           gchar *argv[] )
{
    GtkWidget *window;

    /* 初始化，处理并删去跟 gtk 有关的命令参数 */
    gtk_init (&argc, &argv);

    /* 创建顶级窗口，设置标题，以及窗口是否可缩放 */
    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    gtk_window_set_title (GTK_WINDOW (window), "Color selection test");
    gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, TRUE);

    /* 为 "delete" 和 "destroy" 事件设置回调函数以便退出 */
    g_signal_connect (GTK_OBJECT (window), "delete_event",
    GTK_SIGNAL_FUNC (destroy_window), (gpointer)window);

    /* 创建绘图区，设置尺寸，捕获鼠标按键事件 */
    drawingarea = gtk_drawing_area_new ();

    color.red = 0;
    color.blue = 65535;
    color.green = 0;
    gtk_widget_modify_bg (drawingarea, GTK_STATE_NORMAL, &color);       

    gtk_widget_set_size_request (GTK_WIDGET (drawingarea), 200, 200);

    gtk_widget_set_events (drawingarea, GDK_BUTTON_PRESS_MASK);

    g_signal_connect (GTK_OBJECT (drawingarea), "event", 
    GTK_SIGNAL_FUNC (area_event), (gpointer)drawingarea);

    /* 将绘图区添加到窗口中，然后显示它们 */
    gtk_container_add (GTK_CONTAINER (window), drawingarea);

    gtk_widget_show (drawingarea);
    gtk_widget_show (window);

    /* 进入gtk主循环(这个函数从不会返回) */

    gtk_main ();

    return 0;
}