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` :	Пользовательские данные устанавливаемые при подключении обработчика сигнала.

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру

GtkColorSelection

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

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

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

Свойства

Сигналы

Описание

Детали

GtkColorSelection

gtk_color_selection_new ()

gtk_color_selection_set_update_policy ()

Внимание

gtk_color_selection_set_has_opacity_control ()

gtk_color_selection_get_has_opacity_control ()

gtk_color_selection_set_has_palette ()

gtk_color_selection_get_has_palette ()

gtk_color_selection_get_current_alpha ()

gtk_color_selection_set_current_alpha ()

gtk_color_selection_get_current_color ()

gtk_color_selection_set_current_color ()

gtk_color_selection_get_previous_alpha ()

gtk_color_selection_set_previous_alpha ()

gtk_color_selection_get_previous_color ()

gtk_color_selection_set_previous_color ()

gtk_color_selection_is_adjusting ()

gtk_color_selection_palette_from_string ()

gtk_color_selection_palette_to_string ()

gtk_color_selection_set_change_palette_hook ()

Внимание

GtkColorSelectionChangePaletteFunc ()

gtk_color_selection_set_change_palette_with_screen_hook ()

GtkColorSelectionChangePaletteWithScreenFunc ()

gtk_color_selection_set_color ()

Внимание

gtk_color_selection_get_color ()

Внимание

Детали свойств

Свойство "current-alpha"

Свойство "current-color"

Свойство "has-opacity-control"

Свойство "has-palette"

Детали сигнала

Сигнал "color-changed"

Свойство "`current-alpha`"

Свойство "`current-color`"

Свойство "`has-opacity-control`"

Свойство "`has-palette`"