Spec-Zone.ru › GTK 3.20

GtkВыборЦвета

GtkColorSelection — Устаревшее виджет для выбора цвета

Функции

GtkWidget * gtk_color_selection_new ()
void gtk_color_selection_set_has_opacity_control ()
gboolean gtk_color_selection_get_has_opacity_control ()
void gtk_color_selection_set_has_palette ()
gboolean gtk_color_selection_get_has_palette ()
guint16 gtk_color_selection_get_current_alpha ()
void gtk_color_selection_set_current_alpha ()
void gtk_color_selection_get_current_color ()
void gtk_color_selection_set_current_color ()
guint16 gtk_color_selection_get_previous_alpha ()
void gtk_color_selection_set_previous_alpha ()
void gtk_color_selection_get_previous_color ()
void gtk_color_selection_set_previous_color ()
void gtk_color_selection_get_current_rgba ()
void gtk_color_selection_set_current_rgba ()
void gtk_color_selection_get_previous_rgba ()
void gtk_color_selection_set_previous_rgba ()
gboolean gtk_color_selection_is_adjusting ()
gboolean gtk_color_selection_palette_from_string ()
gchar * gtk_color_selection_palette_to_string ()
void (*GtkColorSelectionChangePaletteFunc) ()
GtkColorSelectionChangePaletteWithScreenFunc gtk_color_selection_set_change_palette_with_screen_hook ()
void (*GtkColorSelectionChangePaletteWithScreenFunc) ()

Свойства

guint current-alpha Чтение / Запись
GdkColor * current-color Чтение / Запись
GdkRGBA * current-rgba Чтение / Запись
gboolean has-opacity-control Чтение / Запись
gboolean has-palette Чтение / Запись

Сигналы

void color-changed Run First

Типы и значения

struct GtkColorSelection
struct GtkColorSelectionClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBox
                    ╰── GtkColorSelection

Реализованные интерфейсы

GtkColorSelection реализует интерфейсы AtkImplementorIface, GtkBuildable и GtkOrientable.

Включаемые файлы

#include <gtk/gtk.h>

Описание

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

Функции

gtk_color_selection_new ()

GtkWidget *
gtk_color_selection_new (void);

gtk_color_selection_new устарело и не должно использоваться в новом коде.

Создаёт новый GtkColorSelection.

Возвращает

новый GtkColorSelection

gtk_color_selection_set_has_opacity_control ()

void
gtk_color_selection_set_has_opacity_control
                               (GtkColorSelection *colorsel,
                                gboolean has_opacity);

gtk_color_selection_set_has_opacity_control устарело и не должно использоваться в новом коде.

Устанавливает colorsel для использования или отключения непрозрачности.

Параметры

colorsel

a GtkColorSelection

has_opacity

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

gtk_color_selection_get_has_opacity_control ()

gboolean
gtk_color_selection_get_has_opacity_control
                               (GtkColorSelection *colorsel);

gtk_color_selection_get_has_opacity_control устарело и не должно использоваться в новом коде.

Определяет, имеет ли colorsel управление непрозрачностью.

Параметры

colorsel

a GtkColorSelection

Возвращает

TRUE, если colorsel имеет управление непрозрачностью, FALSE, если нет

gtk_color_selection_set_has_palette ()

void
gtk_color_selection_set_has_palette (GtkColorSelection *colorsel,
                                     gboolean has_palette);

gtk_color_selection_set_has_palette устарело и не должно использоваться в новом коде.

Отображает и скрывает палитру в зависимости от значения has_palette.

Параметры

colorsel

a GtkColorSelection

has_palette

TRUE, если палитра должна быть видна, FALSE в противном случае

gtk_color_selection_get_has_palette ()

gboolean
gtk_color_selection_get_has_palette (GtkColorSelection *colorsel);

gtk_color_selection_get_has_palette устарело и не должно использоваться в новом коде.

Определяет, имеет ли селектор цвета палитру.

Параметры

colorsel

a GtkColorSelection

Возвращает

TRUE, если селектор имеет палитру, FALSE если нет

gtk_color_selection_get_current_alpha ()

guint16
gtk_color_selection_get_current_alpha (GtkColorSelection *colorsel);

gtk_color_selection_get_current_alpha устарело и не должно использоваться в новом коде.

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

Параметры

colorsel

a GtkColorSelection

Возвращает

целое число от 0 до 65535

gtk_color_selection_set_current_alpha ()

void
gtk_color_selection_set_current_alpha (GtkColorSelection *colorsel,
                                       guint16 alpha);

gtk_color_selection_set_current_alpha устарело и не должно использоваться в новом коде.

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

При первом вызове также установит исходную непрозрачность на alpha.

Параметры

colorsel

a GtkColorSelection

alpha

целое число от 0 до 65535

gtk_color_selection_get_current_color ()

void
gtk_color_selection_get_current_color (GtkColorSelection *colorsel,
                                       GdkColor *color);

gtk_color_selection_get_current_color устарело с версии 3.4 и не должно использоваться в новом коде.

Используйте gtk_color_selection_get_current_rgba() вместо этого.

Устанавливает color в качестве текущего цвета в виджете GtkColorSelection.

Параметры

colorsel

a GtkColorSelection

color

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

[out]

gtk_color_selection_set_current_color ()

void
gtk_color_selection_set_current_color (GtkColorSelection *colorsel,
                                       const GdkColor *color);

gtk_color_selection_set_current_color устарело с версии 3.4 и не должно использоваться в новом коде.

Используйте gtk_color_selection_set_current_rgba() вместо этого.

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

При первом вызове также установит исходный цвет на color.

Параметры

colorsel

a GtkColorSelection

color

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

gtk_color_selection_get_previous_alpha ()

guint16
gtk_color_selection_get_previous_alpha
                               (GtkColorSelection *colorsel);

gtk_color_selection_get_previous_alpha устарело и не должно использоваться в новом коде.

Возвращает предыдущее значение альфа-канала.

Параметры

colorsel

a GtkColorSelection

Возвращает

целое число от 0 до 65535

gtk_color_selection_set_previous_alpha ()

void
gtk_color_selection_set_previous_alpha
                               (GtkColorSelection *colorsel,
                                guint16 alpha);

gtk_color_selection_set_previous_alpha устарело и не должно использоваться в новом коде.

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

Эту функцию следует использовать с осторожностью, так как изменение альфа-канала может показаться запутанным.

Параметры

colorsel

a GtkColorSelection

alpha

целое число от 0 до 65535

gtk_color_selection_get_previous_color ()

void
gtk_color_selection_get_previous_color
                               (GtkColorSelection *colorsel,
                                GdkColor *color);

gtk_color_selection_get_previous_color устарел начиная с версии 3.4 и не должен использоваться в новом коде.

Используйте gtk_color_selection_get_previous_rgba() вместо этого.

Заполняет color исходным значением цвета.

Параметры

colorsel

a GtkColorSelection

color

a GdkColor для заполнения исходным значением цвета.

[out]

gtk_color_selection_set_previous_color ()

void
gtk_color_selection_set_previous_color
                               (GtkColorSelection *colorsel,
                                const GdkColor *color);

gtk_color_selection_set_previous_color устарел начиная с версии 3.4 и не должен использоваться в новом коде.

Используйте gtk_color_selection_set_previous_rgba() вместо этого.

Устанавливает «предыдущий» цвет на color .

Эта функция должна вызываться с осторожностью, так как изменение этого цвета может показаться запутанным. Вызов gtk_color_selection_set_current_color() также установит этот цвет при первом вызове.

Параметры

colorsel

a GtkColorSelection

color

a GdkColor для установки предыдущего цвета

gtk_color_selection_get_current_rgba ()

void
gtk_color_selection_get_current_rgba (GtkColorSelection *colorsel,
                                      GdkRGBA *rgba);

gtk_color_selection_get_current_rgba устарел и не должен использоваться в новом коде.

Устанавливает rgba в качестве текущего цвета в виджете GtkColorSelection.

Параметры

colorsel

a GtkColorSelection

rgba

a GdkRGBA для заполнения текущим цветом.

[out]

С: 3.0

gtk_color_selection_set-current-rgba ()

void
gtk_color_selection_set_current_rgba (GtkColorSelection *colorsel,
                                      const GdkRGBA *rgba);

gtk_color_selection_set_current_rgba устарел и не должен использоваться в новом коде.

Устанавливает текущий цвет на rgba.

При первом вызове он также установит исходный цвет на rgba.

Параметры

colorsel

a GtkColorSelection

rgba

A GdkRGBA для установки текущего цвета

С: 3.0

gtk_color_selection_get_previous_rgba ()

void
gtk_color_selection_get_previous_rgba (GtkColorSelection *colorsel,
                                       GdkRGBA *rgba);

gtk_color_selection_get_previous_rgba устарел и не должен использоваться в новом коде.

Заполняет rgba исходным значением цвета.

Параметры

colorsel

a GtkColorSelection

rgba

a GdkRGBA для заполнения исходным значением цвета.

[out]

С: 3.0

gtk_color_selection_set_previous_rgba ()

void
gtk_color_selection_set_previous_rgba (GtkColorSelection *colorsel,
                                       const GdkRGBA *rgba);

gtk_color_selection_set_previous_rgba устарел и не должен использоваться в новом коде.

Устанавливает «предыдущий» цвет на rgba.

Эта функция должна вызываться с осторожностью, так как изменение этого цвета может показаться запутанным. Вызов gtk_color_selection_set_current_rgba() также установит этот цвет при первом вызове.

Параметры

colorsel

a GtkColorSelection

rgba

a GdkRGBA для установки предыдущего цвета

С: 3.0

gtk_color_selection_is_adjusting ()

gboolean
gtk_color_selection_is_adjusting (GtkColorSelection *colorsel);

gtk_color_selection_is_adjusting устарел и не должен использоваться в новом коде.

Получает текущее состояние colorsel.

Параметры

colorsel

a GtkColorSelection

Возвращает

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

gtk_color_selection_palette_from_string ()

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

gtk_color_selection_palette_from_string устарел и не должен использоваться в новом коде.

Парсит строку палитры; строка представляет собой список имён цветов, разделённых двоеточием, читаемых с помощью gdk_color_parse().

Параметры

str

строка, кодирующая цветовую палитру

colors

место для возвращаемого массива GdkColor.

[out][array length=n_colors]

n_colors

место для возвращаемой длины массива

Возвращает

TRUE если палитра была успешно проанализирована

gtk_color_selection_palette_to_string ()

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

gtk_color_selection_palette_to_string устарел и не должен использоваться в новом коде.

Кодирует палитру в строку, что полезно для сохранения.

Параметры

colors

массив цветов.

[массив длина=n_colors]

n_colors

длина массива

Возвращает

выделенная строка, кодирующая палитру

GtkColorSelectionChangePaletteFunc ()

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

GtkColorSelectionChangePaletteFunc устарел начиная с версии 3.4 и не должен использоваться в новом коде.

Параметры

colors

Массив цветов.

[массив длина=n_colors]

n_colors

Количество цветов в массиве

gtk_color_selection_set_change_palette_with_screen_hook ()

GtkColorSelectionChangePaletteWithScreenFunc
gtk_color_selection_set_change_palette_with_screen_hook
                               (GtkColorSelectionChangePaletteWithScreenFunc func);

gtk_color_selection_set_change_palette_with_screen_hook устарел и не должен использоваться в новом коде.

Устанавливает глобальную функцию, которая вызывается всякий раз, когда пользователь пытается изменить палитру в окне выбора цвета.

Эта функция должна сохранять содержимое новой палитры и обновлять свойство “gtk-color-palette” GtkSettings, чтобы все виджеты GtkColorSelection были изменены.

[пропуск]

Параметры

func

функция, которая вызывается, когда необходимо сохранить пользовательскую палитру

Возвращает

предыдущий обработчик изменения палитры (который был заменен)

С: 2.2

GtkColorSelectionChangePaletteWithScreenFunc ()

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

GtkColorSelectionChangePaletteWithScreenFunc устарел начиная с версии 3.4 и не должен использоваться в новом коде.

Параметры

colors

Массив цветов.

[массив длина=n_colors]

n_colors

Количество цветов в массиве

С: 2.2

Типы и значения

struct GtkColorSelection

struct GtkColorSelection;

struct GtkColorSelectionClass

struct GtkColorSelectionClass {
  GtkBoxClass parent_class;

  void (*color_changed) (GtkColorSelection *color_selection);
};

Члены

color_changed ()

Подробное описание свойств

Свойство “current-alpha”

  “current-alpha”            guint

Текущее значение непрозрачности (0 полностью прозрачный, 65535 полностью непрозрачный).

Флаги: Чтение / Запись

Допустимые значения: <= 65535

Значение по умолчанию: 65535

Свойство “current-color”

  “current-color”            GdkColor *

Текущий цвет GdkColor.

GtkColorSelection:current-color устарел начиная с версии 3.4 и не должен использоваться в новом коде.

Используйте “current-rgba” вместо этого.

Флаги: Чтение / Запись

Свойство “current-rgba”

  “current-rgba”             GdkRGBA *

Текущий RGBA цвет.

Флаги: Чтение / Запись

С: 3.0

Свойство “has-opacity-control”

  “has-opacity-control”      gboolean

Указывает, разрешено ли изменение непрозрачности в селекторе цвета.

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “has-palette”

  “has-palette”              gboolean

Использовать ли палитру.

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Подробное описание сигналов

Сигнал “color-changed”

void
user_function (GtkColorSelection *colorselection,
               gpointer           user_data)

Этот сигнал испускается при изменении цвета в GtkColorSelection в соответствии с политикой обновления.

Параметры

colorselection

объект, получивший сигнал.

user_data

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

Флаги: Run First

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkColorSelection.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API