GtkColorSelection

			GTK+ Reference Manual
Top \| Description \| Object Hierarchy \| Implemented Interfaces \| Properties \| Signals

GtkColorSelection

GtkColorSelection Виджет используемый для выбора цвета

Краткое описание

#include <gtk/gtk.h>


            GtkColorSelection;
GtkWidget*  gtk_color_selection_new         (void);
void        gtk_color_selection_set_update_policy

                                            (GtkColorSelection *colorsel,
                                             GtkUpdateType policy);
void        gtk_color_selection_set_has_opacity_control
                                            (GtkColorSelection *colorsel,
                                             gboolean has_opacity);

gboolean    gtk_color_selection_get_has_opacity_control
                                            (GtkColorSelection *colorsel);
void        gtk_color_selection_set_has_palette
                                            (GtkColorSelection *colorsel,
                                             gboolean has_palette);

gboolean    gtk_color_selection_get_has_palette
                                            (GtkColorSelection *colorsel);
guint16     gtk_color_selection_get_current_alpha
                                            (GtkColorSelection *colorsel);
void        gtk_color_selection_set_current_alpha

                                            (GtkColorSelection *colorsel,
                                             guint16 alpha);
void        gtk_color_selection_get_current_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);
void        gtk_color_selection_set_current_color

                                            (GtkColorSelection *colorsel,
                                             const GdkColor *color);
guint16     gtk_color_selection_get_previous_alpha
                                            (GtkColorSelection *colorsel);
void        gtk_color_selection_set_previous_alpha

                                            (GtkColorSelection *colorsel,
                                             guint16 alpha);
void        gtk_color_selection_get_previous_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);
void        gtk_color_selection_set_previous_color

                                            (GtkColorSelection *colorsel,
                                             const GdkColor *color);
gboolean    gtk_color_selection_is_adjusting
                                            (GtkColorSelection *colorsel);

gboolean    gtk_color_selection_palette_from_string
                                            (const gchar *str,
                                             GdkColor **colors,
                                             gint *n_colors);
gchar*      gtk_color_selection_palette_to_string

                                            (const GdkColor *colors,
                                             gint n_colors);
GtkColorSelectionChangePaletteFunc gtk_color_selection_set_change_palette_hook
                                            (GtkColorSelectionChangePaletteFunc func);
void        (*GtkColorSelectionChangePaletteFunc)
                                            (const GdkColor *colors,
                                             gint n_colors);

GtkColorSelectionChangePaletteWithScreenFunc gtk_color_selection_set_change_palette_with_screen_hook
                                            (GtkColorSelectionChangePaletteWithScreenFunc func);
void        (*GtkColorSelectionChangePaletteWithScreenFunc)
                                            (GdkScreen *screen,
                                             const GdkColor *colors,
                                             gint n_colors);
void        gtk_color_selection_set_color   (GtkColorSelection *colorsel,
                                             gdouble *color);
void        gtk_color_selection_get_color   (GtkColorSelection *colorsel,
                                             gdouble *color);

Иерархия объектов

  GObject
   +----GInitiallyUnowned
         +----GtkObject

               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkVBox
                                       +----GtkColorSelection

Реализуемые интерфейсы

GtkColorSelection реализует AtkImplementorIface.

Свойства

  "current-alpha"        guint                 : Read / Write
  "current-color"        GdkColor              : Read / Write
  "has-opacity-control"  gboolean              : Read / Write
  "has-palette"          gboolean              : Read / Write

Сигналы

"color-changed"
            void        user_function      (GtkColorSelection *colorselection,
                                            gpointer           user_data)           : Run first

Описание

Виджет GtkColorSelection используется для выбора цвета. Он содержит цветовое колесо и числовые слайдеры, а также поле ввода для параметров цвета, таких как тон, насыщенность, значение цвета, красный, зелёный, голубой и прозрачность. Он находится в стандартном диалоге выбора цвета GtkColorSelectionDialog.

Детали

GtkColorSelection

typedef struct _GtkColorSelection GtkColorSelection;
Структура GtkColorSelection
содержит только закрытые данные, и
должна использоваться только функциями
описанными ниже. 


gtk_color_selection_new ()
GtkWidget*  gtk_color_selection_new         (void);
Создаёт новый GtkColorSelection.

	
	
	
		
			Возвращает :
		
		
			новый GtkColorSelection
						
		
	


gtk_color_selection_set_update_policy ()
void        gtk_color_selection_set_update_policy
                                            (GtkColorSelection *colorsel,
                                             GtkUpdateType policy);
Внимание
gtk_color_selection_set_update_policy
устарела и не должна использоваться во
вновь создаваемом коде.
Устанавливает политику контроля за
изданием сигнала color_changed. Допустимой
политикой являются: 


	GTK_UPDATE_CONTINUOUS  беспрерывная
	отправка сигнала пока изменяется цвет.
		
	
GTK_UPDATE_DISCONTINUOUS  сигнал
	отправляется только когда отпущена
	кнопка мыши. 
	
	
GTK_UPDATE_DELAYED  сигнал отправляется
	когда кнопка мыши отпущена или когда
	мышь неподвижна в период времени. 
	


	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			policy :
		
		
			GtkUpdateType
			значение указывающее желательную
			политику. 
			
		
	


gtk_color_selection_set_has_opacity_control ()
void        gtk_color_selection_set_has_opacity_control
                                            (GtkColorSelection *colorsel,
                                             gboolean has_opacity);
Устанавливает colorsel для
использования или не использования
прозрачности.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			has_opacity :
		
		
			TRUE
			если colorsel может установить
			прозрачность, иначе FALSE.
						
		
	


gtk_color_selection_get_has_opacity_control ()
gboolean    gtk_color_selection_get_has_opacity_control
                                            (GtkColorSelection *colorsel);
Определяет имеет ли colorsel контроль
прозрачности.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			Возвращает :
		
		
			TRUE
			если colorsel имеет контроль
			прозрачности. FALSE
			если нет. 
			
		
	


gtk_color_selection_set_has_palette ()
void        gtk_color_selection_set_has_palette
                                            (GtkColorSelection *colorsel,
                                             gboolean has_palette);
Показывает и скрывает палитру основанную
на значении has_palette.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			has_palette :
		
		
			TRUE
			если палитра должна быть видима, иначе
			FALSE.
						
		
	


gtk_color_selection_get_has_palette ()
gboolean    gtk_color_selection_get_has_palette
                                            (GtkColorSelection *colorsel);
Определяет имеет ли селектор выбора
цветовую палитру.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			Возвращает :
		
		
			TRUE
			если селектор имеет палитру. FALSE
			если не имеет. 
			
		
	


gtk_color_selection_get_current_alpha ()
guint16     gtk_color_selection_get_current_alpha
                                            (GtkColorSelection *colorsel);
Возвращает текущеме значение альфа
канала.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			Возвращает :
		
		
			Целочисленное в пределах от 0 до
			65535. 
			
		
	


gtk_color_selection_set_current_alpha ()
void        gtk_color_selection_set_current_alpha
                                            (GtkColorSelection *colorsel,
                                             guint16 alpha);
Устанавливает текущую прозрачность
равную значению alpha. При
первом вызове, она также устанавливает
исходную прозрачность в значение alpha.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			alpha :
		
		
			Целочисленное в пределах от 0 до
			65535. 
			
		
	


gtk_color_selection_get_current_color ()
void        gtk_color_selection_get_current_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);
Устанавливает color значением
текущемго цвета в виджете GtkColorSelection.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			color :
		
		
			GdkColor
			для установки текущемго цвета. 
			
		
	


gtk_color_selection_set_current_color ()
void        gtk_color_selection_set_current_color
                                            (GtkColorSelection *colorsel,
                                             const GdkColor *color);
Устанавливает текущий цвет в значение
color. При первом вызове, она
так же устанавливает исходный цвет в
значение color.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			color :
		
		
			GdkColor
			для установки текущемго цвета. 
			
		
	


gtk_color_selection_get_previous_alpha ()
guint16     gtk_color_selection_get_previous_alpha
                                            (GtkColorSelection *colorsel);
Возвращает предварительно установленное
значение альфа канала.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			Возвращает :
		
		
			Целочисленное в пределах от 0 до
			65535. 
			
		
	


gtk_color_selection_set_previous_alpha ()
void        gtk_color_selection_set_previous_alpha
                                            (GtkColorSelection *colorsel,
                                             guint16 alpha);
Устанавливает 'предыдущий' альфа канал
в значение alpha. Эту функцию
необходимо вызывать с некоторым
перерывом, поскольку наличие изменения
в альфа канале может казаться запутывающим.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			alpha :
		
		
			Целочисленное в пределах от 0 до
			65535. 
			
		
	


gtk_color_selection_get_previous_color ()
void        gtk_color_selection_get_previous_color
                                            (GtkColorSelection *colorsel,
                                             GdkColor *color);
Заполняет color изначальным
значением цвета.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			color :
		
		
			GdkColor
			для заполнения оригинального значения
			цвета. 
			
		
	


gtk_color_selection_set_previous_color ()
void        gtk_color_selection_set_previous_color
                                            (GtkColorSelection *colorsel,
                                             const GdkColor *color);
Устанавливает 'предыдущий' цвет в
значение color. Эту функцию
необходимо вызывать с некоторым
перерывом, поскольку наличие изменения
в цвете может казаться запутывающим.
Вызов gtk_color_selection_set_current_color()
также установит цвет в первоначальное
значение.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			color :
		
		
			GdkColor
			для установки первоначального цвета.
						
		
	


gtk_color_selection_is_adjusting ()
gboolean    gtk_color_selection_is_adjusting
                                            (GtkColorSelection *colorsel);
Выдаёт текущеме состояние colorsel.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			Возвращает :
		
		
			TRUE
			если пользователь в текущий момент
			перемещает цветовой круг, и FALSE
			если выбор остановлен. 
			
		
	


gtk_color_selection_palette_from_string ()
gboolean    gtk_color_selection_palette_from_string
                                            (const gchar *str,
                                             GdkColor **colors,
                                             gint *n_colors);
Анализирует строку цветовой палитры;
строка представляет список разделенных
двоеточиями имён цветов, читаемый
функцией gdk_color_parse().

	
	
	
		
			str :
		
		
			Строка кодов цветов палитры. 
			
		
	
	
		
			colors :
		
		
			Место хранения возвращаемого массива
			GdkColor.
						
		
	
	
		
			n_colors :
		
		
			Место хранения возвращаемого значения
			длины массива. 
			
		
	
	
		
			Возвращает :
		
		
			TRUE
			если палитра полностью проанализирована.
						
		
	


gtk_color_selection_palette_to_string ()
gchar*      gtk_color_selection_palette_to_string
                                            (const GdkColor *colors,
                                             gint n_colors);
Кодирует палитру как строку, полезно
для надёжного хранения.

	
	
	
		
			colors :
		
		
			Массив цветов. 
			
		
	
	
		
			n_colors :
		
		
			Длина массива. 
			
		
	
	
		
			Возвращает :
		
		
			Строка закодированной палитры. 
			
		
	


gtk_color_selection_set_change_palette_hook ()
GtkColorSelectionChangePaletteFunc gtk_color_selection_set_change_palette_hook
                                            (GtkColorSelectionChangePaletteFunc func);
Внимание
gtk_color_selection_set_change_palette_hook
устарела и не должна использоваться во
вновь создаваемом коде. Эта функция
заменена
gtk_color_selection_set_change_palette_with_screen_hook(),
и не работает в многопоточных средах.
Устанавливает глобальную функцию,
которая вызывается каждый раз когда
пользователь пытается изменить палитру
в селекторе цвета. Эта функция должна
сохранять новое содержимое палитры и
обновлять GtkSettings свойство "gtk-color-palette",
таким образом все GtkColorSelection виджеты
будут изменены.

	
	
	
		
			func :
		
		
			Функция вызываемая когда необходимо
			сохранить изменения палитры. 
			
		
	
	
		
			Возвращает :
		
		
			Предыдущая обработанная изменяемая
			палитра (которая заменяется). 
			
		
	


GtkColorSelectionChangePaletteFunc ()
void        (*GtkColorSelectionChangePaletteFunc)
                                            (const GdkColor *colors,
                                             gint n_colors);

	
	
	
		
			colors :
		
		
	
	
		
			n_colors :
		
		
	


gtk_color_selection_set_change_palette_with_screen_hook ()
GtkColorSelectionChangePaletteWithScreenFunc gtk_color_selection_set_change_palette_with_screen_hook
                                            (GtkColorSelectionChangePaletteWithScreenFunc func);
Устанавливает глобальную функцию,
которая вызывается каждый раз когда
пользователь пытается изменить палитру
в селекторе цвета. Эта функция должна
сохранять новое содержимое палитры, и
обновлять GtkSettings свойство "gtk-color-palette",
таким образом все GtkColorSelection виджеты
будут изменены.

	
	
	
		
			func :
		
		
			Функция вызываемая когда необходимо
			сохранить изменения палитры. 
			
		
	
	
		
			Возвращает :
		
		
			Предыдущая обработанная изменяемая
			палитра (которая заменяется). 
			
		
	

Начиная с версии 2.2 


GtkColorSelectionChangePaletteWithScreenFunc ()
void        (*GtkColorSelectionChangePaletteWithScreenFunc)
                                            (GdkScreen *screen,
                                             const GdkColor *colors,
                                             gint n_colors);

	
	
	
		
			screen :
		
		
	
	
		
			colors :
		
		
	
	
		
			n_colors :
		
		
	

Начиная с версии 2.2 


gtk_color_selection_set_color ()
void        gtk_color_selection_set_color   (GtkColorSelection *colorsel,
                                             gdouble *color);
Внимание
gtk_color_selection_set_color
устарела и не должна использоваться во
вновь создаваемом коде. Вместо неё
используйте gtk_color_selection_set_current_color().
Устанавливает текущий цвет в значение
color. При первом вызове, она
также установит оригинальный цвет в
значение color.

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			color :
		
		
			Массив четырех пар определяющих
			красный, зеленый, голубой и прозрачность
			для установки текущемго цвета. 
			
		
	


gtk_color_selection_get_color ()
void        gtk_color_selection_get_color   (GtkColorSelection *colorsel,
                                             gdouble *color);
Внимание
gtk_color_selection_get_color
устарела и не должна использоваться во
вновь создаваемом коде.
Устанавливает color текущим
цветом в виджете GtkColorSelection. 

Эта функция устарела, вместо неё
используйте gtk_color_selection_get_current_color().

	
	
	
		
			colorsel :
		
		
			GtkColorSelection.
						
		
	
	
		
			color :
		
		
			массив 4 gdouble
			для заполнения текущемго цвета. 
			
		
	

Детали свойств
Свойство "current-alpha"
  "current-alpha"        guint                 : Read / Write
Текущее значение прозрачности (0 полная
прозрачность, 65535 полная не прозрачность).
Допустимые значения: <= 65535
Значение по умолчанию: 65535

Свойство "current-color"
  "current-color"        GdkColor              : Read / Write
Текущий цвет.

Свойство "has-opacity-control"
  "has-opacity-control"  gboolean              : Read / Write
Позволяет ли селектор цвета установку
прозрачности.
Значение по умолчанию: FALSE

Свойство "has-palette"
  "has-palette"          gboolean              : Read / Write
Должна ли использоваться палитра.
Значение по умолчанию: FALSE
Детали сигнала
Сигнал "color-changed"
void        user_function                  (GtkColorSelection *colorselection,
                                            gpointer           user_data)           : Run first
Этот сигнал издаётся при изменении
цвета в GtkColorSelection
согласно политики обновления. 


	
	
	
		
			colorselection :
		
		
			Объект получающий сигнал. 
			
		
	
	
		
			user_data :
		
		
			Пользовательские данные устанавливаемые
			при подключении обработчика сигнала.

`colorsel` :	GtkColorSelection.
`has_opacity` :	`TRUE` если `colorsel` может установить прозрачность, иначе `FALSE`.

`colorsel` :	GtkColorSelection.
Возвращает :	`TRUE` если `colorsel` имеет контроль прозрачности. `FALSE` если нет.

`colorsel` :	GtkColorSelection.
`has_palette` :	`TRUE` если палитра должна быть видима, иначе `FALSE`.

`colorsel` :	GtkColorSelection.
Возвращает :	`TRUE` если селектор имеет палитру. `FALSE` если не имеет.

`colorsel` :	GtkColorSelection.
Возвращает :	`TRUE` если пользователь в текущий момент перемещает цветовой круг, и `FALSE` если выбор остановлен.

`colorsel` :	GtkColorSelection.
`policy` :	GtkUpdateType значение указывающее желательную политику.

`colorsel` :	GtkColorSelection.
`alpha` :	Целочисленное в пределах от 0 до 65535.

`colorsel` :	GtkColorSelection.
`color` :	GdkColor для установки текущемго цвета.

`colorsel` :	GtkColorSelection.
`color` :	GdkColor для установки текущемго цвета.

`colorsel` :	GtkColorSelection.
`alpha` :	Целочисленное в пределах от 0 до 65535.

`str` :	Строка кодов цветов палитры.
`colors` :	Место хранения возвращаемого массива GdkColor.
`n_colors` :	Место хранения возвращаемого значения длины массива.
Возвращает :	`TRUE` если палитра полностью проанализирована.

`colors` :	Массив цветов.
`n_colors` :	Длина массива.
Возвращает :	Строка закодированной палитры.

`func` :	Функция вызываемая когда необходимо сохранить изменения палитры.
Возвращает :	Предыдущая обработанная изменяемая палитра (которая заменяется).

`func` :	Функция вызываемая когда необходимо сохранить изменения палитры.
Возвращает :	Предыдущая обработанная изменяемая палитра (которая заменяется).

`colorselection` :	Объект получающий сигнал.
`user_data` :	Пользовательские данные устанавливаемые при подключении обработчика сигнала.

`screen` :
`colors` :
`n_colors` :