Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties  |  Signals

GtkColorButton

GtkColorButton Кнопка запуска диалога для выбора цвета

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

#include <gtk/gtk.h> GtkColorButton; GtkWidget* gtk_color_button_new (void); GtkWidget* gtk_color_button_new_with_color (const GdkColor *color); void gtk_color_button_set_color (GtkColorButton *color_button, const GdkColor *color); void gtk_color_button_get_color (GtkColorButton *color_button, GdkColor *color); void gtk_color_button_set_alpha (GtkColorButton *color_button, guint16 alpha); guint16 gtk_color_button_get_alpha (GtkColorButton *color_button); void gtk_color_button_set_use_alpha (GtkColorButton *color_button, gboolean use_alpha); gboolean gtk_color_button_get_use_alpha (GtkColorButton *color_button); void gtk_color_button_set_title (GtkColorButton *color_button, const gchar *title); const gchar* gtk_color_button_get_title (GtkColorButton *color_button);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----GtkColorButton

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

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

Свойства

"alpha" guint : Read / Write "color" GdkColor : Read / Write "title" gchararray : Read / Write "use-alpha" gboolean : Read / Write

Сигналы

"color-set" void user_function (GtkColorButton *widget, gpointer user_data) : Run first

Описание

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