GtkColorButton

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

Функции

GtkWidget *	gtk_color_button_new ()
GtkWidget *	gtk_color_button_new_with_color ()
GtkWidget *	gtk_color_button_new_with_rgba ()
void	gtk_color_button_set_color ()
void	gtk_color_button_get_color ()
void	gtk_color_button_set_alpha ()
guint16	gtk_color_button_get_alpha ()
void	gtk_color_button_set_rgba ()
void	gtk_color_button_get_rgba ()
void	gtk_color_button_set_use_alpha ()
gboolean	gtk_color_button_get_use_alpha ()
void	gtk_color_button_set_title ()
const gchar *	gtk_color_button_get_title ()

Свойства

guint	alpha	Чтение/Запись
GdkColor *	color	Чтение/Запись
GdkRGBA *	rgba	Чтение/Запись
gboolean	show-editor	Чтение/Запись
gchar *	title	Чтение/Запись
gboolean	use-alpha	Чтение/Запись

Сигналы

void

color-set

Run First

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

struct

GtkColorButton

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkButton
                        ╰── GtkColorButton

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

GtkColorButton реализует AtkImplementorIface, GtkBuildable, GtkActionable, GtkActivatable и GtkColorChooser.

Файлы заголовков

#include <gtk/gtk.h>

Описание

Кнопка GtkColorButton отображает выбранный цвет и позволяет открыть диалог выбора цвета для его изменения. Подходит для выбора цвета в диалоге настроек.

Узлы CSS

GtkColorButton имеет единственный узел CSS с именем button. Чтобы отличить его от обычной кнопки GtkButton, он получает стиль класса .color.

Функции

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);

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

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

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

Параметры

color

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

Возвращаемое значение

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

С версии: 2.4

gtk_color_button_new_with_rgba ()

GtkWidget *
gtk_color_button_new_with_rgba (const GdkRGBA *rgba);

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

Параметры

rgba

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

Возвращаемое значение

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

С версии: 3.0

gtk_color_button_set_color ()

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

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

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

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

Параметры

button	кнопка GtkColorButton
color	Значение GdkColor для установки текущего цвета

С версии: 2.4

gtk_color_button_get_color ()

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

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

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

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

Параметры

button	кнопка GtkColorButton
color	Значение GdkColor для заполнения текущим цветом.	[out]

С версии: 2.4

gtk_color_button_set_alpha ()

void
gtk_color_button_set_alpha (GtkColorButton *button,
                            guint16 alpha);

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

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

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

Параметры

button	кнопка GtkColorButton
alpha	целое число от 0 до 65535

С версии: 2.4

gtk_color_button_get_alpha ()

guint16
gtk_color_button_get_alpha (GtkColorButton *button);

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

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

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

Параметры

button

кнопка GtkColorButton

Возвращаемое значение

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

С версии: 2.4

gtk_color_button_set_rgba ()

void
gtk_color_button_set_rgba (GtkColorButton *button,
                           const GdkRGBA *rgba);

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

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

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

[skip]

Параметры

button	кнопка GtkColorButton
rgba	значение GdkRGBA для установки текущего цвета

С версии: 3.0

gtk_color_button_get_rgba ()

void
gtk_color_button_get_rgba (GtkColorButton *button,
                           GdkRGBA *rgba);

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

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

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

[skip]

Параметры

button	кнопка GtkColorButton
rgba	значение GdkRGBA для заполнения текущим цветом.	[out]

С версии: 3.0

gtk_color_button_set_use_alpha ()

void
gtk_color_button_set_use_alpha (GtkColorButton *button,
                                gboolean use_alpha);

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

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

Устанавливает, использовать ли альфа-канал в кнопке выбора цвета.

Параметры

button	кнопка GtkColorButton
use_alpha	`TRUE`, если кнопка должна использовать альфа-канал, `FALSE`, если нет

С версии: 2.4

gtk_color_button_get_use_alpha ()

gboolean
gtk_color_button_get_use_alpha (GtkColorButton *button);

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

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

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

Параметры

button

a GtkColorButton

Возвращаемое значение

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

С версии: 2.4

gtk_color_button_set_title ()

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

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

Параметры

button	a GtkColorButton
title	Строка, содержащая новый заголовок окна

С версии: 2.4

gtk_color_button_get_title ()

const gchar *
gtk_color_button_get_title (GtkColorButton *button);

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

Параметры

button

a GtkColorButton

Возвращаемое значение

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

С версии: 2.4

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

struct GtkColorButton

struct GtkColorButton;

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

Свойство `“alpha”`

  “alpha”                    guint

Выбранное значение непрозрачности (0 — полностью прозрачный, 65535 — полностью непрозрачный).

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

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

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

С версии: 2.4

Свойство `“color”`

  “color”                    GdkColor *

Выбранный цвет.

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

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

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

С версии: 2.4

Свойство `“rgba”`

  “rgba”                     GdkRGBA *

Цвет RGBA.

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

С версии: 3.0

Свойство `“show-editor”`

  “show-editor”              gboolean

Установите это свойство в TRUE, чтобы пропустить палитру в диалоге и перейти непосредственно к редактору цветов.

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

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

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

С версии: 3.20

Свойство `“title”`

  “title”                    gchar *

Заголовок диалога выбора цвета

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

Значение по умолчанию: "Выбрать цвет"

С версии: 2.4

Свойство `“use-alpha”`

  “use-alpha”                gboolean

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

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

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

С версии: 2.4

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

Сигнал `“color-set”`

void
user_function (GtkColorButton *widget,
               gpointer        user_data)

Сигнал ::color-set генерируется, когда пользователь выбирает цвет. При обработке этого сигнала используйте gtk_color_button_get_rgba(), чтобы узнать, какой цвет был только что выбран.

Обратите внимание, что этот сигнал генерируется только при изменении цвета пользователем. Если вам нужно реагировать и на программные изменения цвета, используйте сигнал notify::color.

Параметры

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

Флаги: Run First

С версии: 2.4

См. также

GtkColorSelectionDialog, GtkFontButton

© 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/GtkColorButton.html

GtkColorButton

Функции

Свойства

Сигналы

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

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

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

Файлы заголовков

Описание

Узлы CSS

Функции

gtk_color_button_new ()

Возвращаемое значение

gtk_color_button_new_with_color ()

Параметры

Возвращаемое значение

gtk_color_button_new_with_rgba ()

Параметры

Возвращаемое значение

gtk_color_button_set_color ()

Параметры

gtk_color_button_get_color ()

Параметры

gtk_color_button_set_alpha ()

Параметры

gtk_color_button_get_alpha ()

Параметры

Возвращаемое значение

gtk_color_button_set_rgba ()

Параметры

gtk_color_button_get_rgba ()

Параметры

gtk_color_button_set_use_alpha ()

Параметры

gtk_color_button_get_use_alpha ()

Параметры

Возвращаемое значение

gtk_color_button_set_title ()

Параметры

gtk_color_button_get_title ()

Параметры

Возвращаемое значение

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

struct GtkColorButton

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

Свойство “alpha”

Свойство “color”

Свойство “rgba”

Свойство “show-editor”

Свойство “title”

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

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

Сигнал “color-set”

Параметры

См. также

Свойство `“alpha”`

Свойство `“color”`

Свойство `“rgba”`

Свойство `“show-editor”`

Свойство `“title”`

Свойство `“use-alpha”`

Сигнал `“color-set”`