GTK+ 2.0 教学-颜色选择 Color Selection

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

目前，颜色选择元件只能引发一种信号： 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三个按钮的横向盒(HBox)。你可以透过存取颜色选择对话框元件结构中的”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” 信号时，使用这些函式。

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

#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);
}

/* 绘图区事件处理函式 */

static gboolean 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);
　　　　/* Connect to the "color_changed" signal, set the client-data
       * to the colorsel widget */
      g_signal_connect (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;
}

/* 关闭、退出的事件处理函式 */
static gboolean 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_resizable ((GTK_WINDOW (window), TRUE);

/* 为 "delete" 和 "destroy" 事件设置回呼函式以便退出 */
g_signal_connect (window, "delete-event",
                    G_CALLBACK (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",
	            G_CALLBACK (area_event), (gpointer) drawingarea);

/* 将绘图区添加到视窗中，然后显示它们 */

gtk_container_add (GTK_CONTAINER (window), drawingarea);

gtk_widget_show (drawingarea);
gtk_widget_show (window);

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

gtk_main ();

/* 满足性情暴躁的编译器 */

return 0;
}

« GTK+ 2.0 教学-日历 Calendar

GTK+ 2.0 教学

GTK+ 2.0 教学-档案选择 File Selections »

GTK+ 2.0 教学-颜色选择 Color Selection

3 則留言