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

Первым выполняется

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

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

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

Возвращает

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

С версии: 2.4

gtk_color_button_new_with_rgba ()

GtkWidget *
gtk_color_button_new_with_rgba (const GdkRGBA *rgba);

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

Параметры

rgba

A 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	a GtkColorButton
color	A 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	a GtkColorButton
color	a 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	a 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

a 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	a GtkColorButton
rgba	a 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	a GtkColorButton
rgba	a 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	a 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() вместо этого.

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

Параметры

кнопка

a GtkColorButton

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

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

С: 2.4

gtk_color_button_set_title ()

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

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

Параметры

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

С: 2.4

gtk_color_button_get_title ()

const gchar *
gtk_color_button_get_title (GtkColorButton *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.20/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”`