Spec-Zone.ru › GTK 3.22

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

a 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

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

[массив length=n_colors]

n_colors

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

Возвращает

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

GtkColorSelectionChangePaletteFunc ()

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

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

Параметры

colors

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

[массив length=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

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

[массив length=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

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

Флаги: Первое выполнение

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

Spec-Zone.ru

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