GtkScale

gtk_scale_new ()

GtkWidget *
gtk_scale_new (GtkOrientation orientation,
               GtkAdjustment *adjustment);

Создаёт новый GtkScale.

С: 3.0

gtk_scale_new_with_range ()

GtkWidget *
gtk_scale_new_with_range (GtkOrientation orientation,
                          gdouble min,
                          gdouble max,
                          gdouble step);

Создаёт виджет шкалы с заданным направлением, позволяющий пользователю ввести число от min до max (включая min и max ) с шагом step. step должно быть отличным от нуля; это расстояние, на которое движется ползунок при использовании стрелок для изменения значения шкалы.

Обратите внимание, что способ вычисления точности лучше всего работает, если step является степенью десяти. Если полученная точность не подходит для ваших нужд, используйте gtk_scale_set_digits() для её коррекции.

С: 3.0

gtk_scale_set_digits ()

void
gtk_scale_set_digits (GtkScale *scale,
                      gint digits);

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

Обратите внимание, что округление до небольшого количества знаков может повлиять на плавную автоматическую прокрутку, встроенную в GtkScale. В качестве альтернативы можно использовать сигнал “format-value” для самостоятельного форматирования отображаемого значения.

gtk_scale_set_draw_value ()

void
gtk_scale_set_draw_value (GtkScale *scale,
                          gboolean draw_value);

Указывает, отображается ли текущее значение как строка рядом с ползунком.

gtk_scale_set_has-origin ()

void
gtk_scale_set_has_origin (GtkScale *scale,
                          gboolean has_origin);

Если has_origin установлено в TRUE (по умолчанию), шкала выделит часть шкалы между началом (нижняя или левая сторона) шкалы и текущим значением.

С: 3.4

gtk_scale_set_value_pos ()

void
gtk_scale_set_value_pos (GtkScale *scale,
                         GtkPositionType pos);

Устанавливает позицию, на которой отображается текущее значение.

gtk_scale_get_digits ()

gint
gtk_scale_get_digits (GtkScale *scale);

Возвращает количество десятичных знаков, отображаемых в значении.

gtk_scale_get_draw_value ()

gboolean
gtk_scale_get_draw_value (GtkScale *scale);

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

gtk_scale_get_has-origin ()

gboolean
gtk_scale_get_has_origin (GtkScale *scale);

Возвращает, имеет ли шкала начало.

С: 3.4

gtk_scale_get_value_pos ()

GtkPositionType
gtk_scale_get_value_pos (GtkScale *scale);

Возвращает позицию, на которой отображается текущее значение.

gtk_scale_get_layout ()

PangoLayout *
gtk_scale_get_layout (GtkScale *scale);

Получает PangoLayout, используемый для отображения шкалы. Возвращаемый объект принадлежит шкале, поэтому вызывающий код не должен его освобождать.

С: 2.4

gtk_scale_get_layout_offsets ()

void
gtk_scale_get_layout_offsets (GtkScale *scale,
                              gint *x,
                              gint *y);

Получает координаты, в которых шкала нарисует PangoLayout, представляющий текст на шкале. Помните, что при использовании функций PangoLayout необходимо конвертировать в и из пикселей, используя PANGO_PIXELS() или PANGO_SCALE.

Если свойство “draw-value” равно FALSE, значения возвращаемых параметров не определены.

С: 2.4

gtk_scale_add_mark ()

void
gtk_scale_add_mark (GtkScale *scale,
                    gdouble value,
                    GtkPositionType position,
                    const gchar *markup);

Добавляет метку в value .

Метка визуализируется как отметка рядом со шкалой, и GTK+ позволяет пользователю точно установить значение шкалы на метке.

Если markup не NULL, рядом с меткой отображается текст.

Чтобы удалить метки со шкалы, используйте gtk_scale_clear_marks().

С: 2.16

gtk_scale_clear_marks ()

void
gtk_scale_clear_marks (GtkScale *scale);

Удаляет все метки, добавленные с помощью gtk_scale_add_mark().

С: 2.16