Spec-Zone.ru › GTK 3.24

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 Чтение/Запись
char * 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() вместо этого.

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

Параметры

цвет

Значение 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.

Параметры

кнопка

Объект GtkColorButton

цвет

Значение 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.

Параметры

кнопка

Объект GtkColorButton

цвет

Объект 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.

Параметры

кнопка

Объект 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() вместо этого.

Возвращает текущее значение alpha.

Параметры

кнопка

Объект 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]

Параметры

кнопка

Объект 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]

Параметры

кнопка

Объект 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() вместо этого.

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

Параметры

кнопка

Объект GtkColorButton

use_alpha

TRUE если кнопка выбора цвета должна использовать канал alpha, 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

кнопка GtkColorButton

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

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

С: 2.4

gtk_color_button_set_title ()

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

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

Параметры

button

кнопка GtkColorButton

title

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

С: 2.4

gtk_color_button_get_title ()

const gchar *
gtk_color_button_get_title (GtkColorButton *button);

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

Параметры

button

кнопка GtkColorButton

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

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

С: 2.4

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

struct GtkColorButton

struct GtkColorButton;

Подробности свойств

Свойство “alpha”

  “alpha”                    guint

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

Владелец: GtkColorButton

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

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

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

С: 2.4

Свойство “color”

  “color”                    GdkColor *

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

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

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

Владелец: GtkColorButton

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

С: 2.4

Свойство “rgba”

  “rgba”                     GdkRGBA *

Цвет RGBA.

Владелец: GtkColorButton

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

С: 3.0

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

  “show-editor”              gboolean

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

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

Владелец: GtkColorButton

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

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

С: 3.20

Свойство “title”

  “title”                    char *

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

Владелец: GtkColorButton

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

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

С: 2.4

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

  “use-alpha”                gboolean

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

Владелец: GtkColorButton

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

Значение по умолчанию: 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

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

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

С: 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.24/GtkColorButton.html

Spec-Zone.ru

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