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

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

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

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

Свойства

Сигналы

Описание

GtkColorButton это кнопка которая отображает текущий выбранный цвет и позволяет открывать диалог выбора цвета для его изменения. Это удобный виджет для выбора цвета в диалоге параметров.

Детали

GtkColorButton

typedef struct _GtkColorButton GtkColorButton;

Структура GtkColorButton содержит только
закрытые данные и должна использоваться
только функциями описанными ниже. 


gtk_color_button_new ()
GtkWidget*  gtk_color_button_new            (void);

Создаёт новую кнопку выбора цвета.
Возвращается виджет в форме небольшой
кнопки содержащей образец текущемго
выбранного цвета. При нажатии на кнопку
открывается диалог выбора цвета,
позволяющий пользователю выбрать цвет.
Образец на кнопке будет отражать новый
цвет после того как пользователь завершит
выбор.

	
	
	

		

			
Возвращает :
		
		

			
Новая кнопка выбора цвета. 
			
		
	

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


gtk_color_button_new_with_color ()
GtkWidget*  gtk_color_button_new_with_color (const GdkColor *color);

Создаёт новую кнопку выбора цвета.

	
	
	

		

			
color :
		
		

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

		

			
Возвращает :
		
		

			
Новая кнопка выбора цвета. 
			
		
	

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


gtk_color_button_set_color ()
void        gtk_color_button_set_color      (GtkColorButton *color_button,
                                             const GdkColor *color);

Устанавливает текущий цвет в значение
color.

	
	
	

		

			
color_button :
		
		

			
GtkColorButton. 
			
		
	
	

		

			
color :
		
		

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

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


gtk_color_button_get_color ()
void        gtk_color_button_get_color      (GtkColorButton *color_button,
                                             GdkColor *color);

Устанавливает color в текущий
цвет в виджете GtkColorButton.

	
	
	

		

			
color_button :
		
		

			
GtkColorButton. 
			
		
	
	

		

			
color :
		
		

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

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


gtk_color_button_set_alpha ()
void        gtk_color_button_set_alpha      (GtkColorButton *color_button,
                                             guint16 alpha);

Устанавливает текущую прозрачность в
значение alpha.

	
	
	

		

			
color_button :
		
		

			
GtkColorButton. 
			
		
	
	

		

			
alpha :
		
		

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

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


gtk_color_button_get_alpha ()
guint16     gtk_color_button_get_alpha      (GtkColorButton *color_button);

Возвращает текущеме значение альфа
канала.

	
	
	

		

			
color_button :
		
		

			
GtkColorButton. 
			
		
	
	

		

			
Возвращает :
		
		

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

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


gtk_color_button_set_use_alpha ()
void        gtk_color_button_set_use_alpha  (GtkColorButton *color_button,
                                             gboolean use_alpha);

Устанавливает должна ли кнопка
использовать альфа канал.

	
	
	

		

			
color_button :
		
		

			
GtkColorButton. 
			
		
	
	

		

			
use_alpha :
		
		

			
TRUE
			если кнопка выбора цвета должна
			использовать альфа канал, FALSE
			если нет. 
			
		
	

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


gtk_color_button_get_use_alpha ()
gboolean    gtk_color_button_get_use_alpha  (GtkColorButton *color_button);

Использует ли диалог выбора цвета альфа
канал?

	
	
	

		

			
color_button :
		
		

			
GtkColorButton. 
			
		
	
	

		

			
Возвращает :
		
		

			
TRUE
			если образец цвета использует альфа
			канал, FALSE
			если нет. 
			
		
	

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


gtk_color_button_set_title ()
void        gtk_color_button_set_title      (GtkColorButton *color_button,
                                             const gchar *title);

Устанавливает заголовок для диалога
выбора цвета.

	
	
	

		

			
color_button :
		
		

			
GtkColorButton 
			
		
	
	

		

			
title :
		
		

			
Строка содержащая новый заголовок
			окна. 
			
		
	

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


gtk_color_button_get_title ()
const gchar* gtk_color_button_get_title     (GtkColorButton *color_button);

Возвращает заголовок диалога выбора
цвета.

	
	
	

		

			
color_button :
		
		

			
GtkColorButton 
			
		
	
	

		

			
Возвращает :
		
		

			
Внутренняя строка, не освобождайте
			возвращаемое значение 
			
		
	

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

Детали свойств
Свойство "alpha"
  "alpha"                guint                 : Read / Write

Выбранное значение прозрачности (0
полная прозрачность, 65535 полностью
непрозрачный).
Допустимые значения: <= 65535
Значение по умолчанию: 65535
Начиная с версии 2.4 


Свойство "color"
  "color"                GdkColor              : Read / Write

Выбранный цвет.
Начиная с версии 2.4 


Свойство "title"
  "title"                gchararray            : Read / Write

Заголовок диалога выбора цвета.
Значение по умолчанию: "Pick a Color"
Начиная с версии 2.4 


Свойство "use-alpha"
  "use-alpha"            gboolean              : Read / Write

Если это свойство установлено в значение
TRUE,
образец цвета на кнопке изображается
сквозь шахматный фон для отображения
его прозрачности, а ползунок прозрачности
отображается в диалоге выбора цвета.
Значение по умолчанию: FALSE
Начиная с версии 2.4 

Детали сигнала
Сигнал "color-set"
void        user_function                  (GtkColorButton *widget,
                                            gpointer        user_data)      : Run first

Сигнал ::color-set издаётся когда пользователь
выбрал цвет. Когда обрабатывается этот
сигнал, используются gtk_color_button_get_color()
и gtk_color_button_get_alpha()
для обнаружения цвета который был
выбран. 

Помните, сигнал издаётся только когда
пользователь изменяет цвет. Если
вам нужна реакция на программное
изменение цвета, используйте сигнал
notify::color.

	
	
	

		

			
widget :
		
		

			
Объект который получает сигнал. 
			
		
	
	

		

			
user_data :
		
		

			
Пользовательские данные устанавливаемые
			при подключении обработчика сигнала.
		
	

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

Смотрите также
GtkColorSelectionDialog,
GtkFontButton