颜色选择 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" 信号时，使用这些函数。
下面是一个简单的示例，它演示了如何使用颜色选择对话框构件。这个程序显示了一个包含绘图区的窗口。点击它会打开一个颜色选择对话框，改变颜色选择对话框中的颜色，会改变绘图区的背景色。
#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;
} |