GtkColorButton
GtkColorButton — Кнопка для запуска диалога выбора цвета
Функции
| GtkWidget * | gtk_color_button_new () |
| GtkWidget * | gtk_color_button_new_with_rgba () |
| void | gtk_color_button_set_title () |
| const char * | gtk_color_button_get_title () |
| void | gtk_color_button_set_modal () |
| gboolean | gtk_color_button_get_modal () |
Свойства
| gboolean | modal | Чтение / Запись |
| gboolean | show-editor | Чтение / Запись |
| char * | title | Чтение / Запись |
Сигналы
| void | color-set | Выполняется первым |
Типы и значения
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkColorButton
Реализованные интерфейсы
GtkColorButton реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkColorChooser.
Включаемые файлы
#include <gtk/gtk.h>
Описание
GtkColorButton — это кнопка, которая отображает выбранный цвет и позволяет открыть диалог выбора цвета для изменения цвета. Она подходит для выбора цвета в диалоге настроек.
CSS-узлы
colorbutton
╰── button.color
╰── [content]GtkColorButton имеет один CSS-узел с именем colorbutton, который содержит узел кнопки. Чтобы отличить его от обычной GtkButton, ему присваивается класс стиля .color.
Подробное описание функций
gtk_color_button_new ()
GtkWidget *
gtk_color_button_new (void); Создаёт новую кнопку выбора цвета.
Возвращает виджет в форме небольшой кнопки, содержащей образец, представляющий текущий выбранный цвет. При нажатии кнопки откроется диалог выбора цвета, позволяющий пользователю выбрать цвет. Образец будет обновлён, чтобы отразить новый цвет, когда пользователь закончит.
Возвращаемое значение
новая кнопка выбора цвета
gtk_color_button_new_with_rgba ()
GtkWidget *
gtk_color_button_new_with_rgba (const GdkRGBA *rgba); Создаёт новую кнопку выбора цвета.
Параметры
rgba | A GdkRGBA для установки текущего цвета |
Возвращаемое значение
новая кнопка выбора цвета
gtk_color_button_set_title ()
void gtk_color_button_set_title (GtkColorButton *button,const char *title);
Устанавливает заголовок для диалога выбора цвета.
Параметры
button | ||
title | Строка с новым заголовком окна |
gtk_color_button_get_title ()
const char *
gtk_color_button_get_title (GtkColorButton *button); Получает заголовок диалога выбора цвета.
Параметры
button |
Возвращаемое значение
Внутренняя строка, не освобождайте возвращённое значение
gtk_color_button_set_modal ()
void gtk_color_button_set_modal (GtkColorButton *button,gboolean modal);
Устанавливает, должен ли диалог быть модальным.
Параметры
button | ||
modal |
|
gtk_color_button_get_modal ()
gboolean
gtk_color_button_get_modal (GtkColorButton *button); Получает, является ли диалог модальным.
Параметры
button |
Возвращаемое значение
TRUE если диалог модальный
Типы и значения
GtkColorButton
typedef struct _GtkColorButton GtkColorButton;
Подробности свойств
Свойство “modal”
“modal” gboolean
Является ли диалог модальным.
Владелец: GtkColorButton
Флаги: Чтение / Запись
Значение по умолчанию: ИСТИНА
Свойство “show-editor”
“show-editor” gboolean
Установите это свойство в TRUE, чтобы пропустить палитру в диалоге и перейти непосредственно к редактору цвета.
Это свойство следует использовать в тех случаях, когда палитра в редакторе избыточна, например, когда кнопка цвета уже является частью палитры.
Владелец: GtkColorButton
Флаги: Чтение / Запись
Значение по умолчанию: ЛОЖЬ
Свойство “title”
“title” char *
Заголовок диалога выбора цвета
Владелец: GtkColorButton
Флаги: Чтение / Запись
Значение по умолчанию: «Выбрать цвет»
Подробности сигналов
Сигнал “color-set”
void user_function (GtkColorButton *widget, gpointer user_data)
Сигнал ::color-set генерируется, когда пользователь выбирает цвет. При обработке этого сигнала используйте gtk_color_chooser_get_rgba(), чтобы узнать, какой цвет был только что выбран.
Обратите внимание, что этот сигнал генерируется только при изменении цвета пользователем. Если вам необходимо реагировать также на программные изменения цвета, используйте сигнал notify::color.
Параметры
widget | объект, который получил сигнал. | |
user_data | пользовательские данные, установленные при подключении обработчика сигнала. |
Флаги: Выполняется первым
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkColorButton.html