Spec-Zone.ru › GTK 4.0

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 Выполняется первым

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

GtkColorButton

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

    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

a GtkColorButton

title

Строка с новым заголовком окна

gtk_color_button_get_title ()

const char *
gtk_color_button_get_title (GtkColorButton *button);

Получает заголовок диалога выбора цвета.

Параметры

button

a GtkColorButton

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

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

gtk_color_button_set_modal ()

void
gtk_color_button_set_modal (GtkColorButton *button,
                            gboolean modal);

Устанавливает, должен ли диалог быть модальным.

Параметры

button

a GtkColorButton

modal

TRUE для того, чтобы сделать диалог модальным

gtk_color_button_get_modal ()

gboolean
gtk_color_button_get_modal (GtkColorButton *button);

Получает, является ли диалог модальным.

Параметры

button

a GtkColorButton

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

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

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

Флаги: Выполняется первым

См. также

GtkFontButton

© 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

Spec-Zone.ru

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