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);

Устанавливает количество десятичных знаков, отображаемых в значении. Также приводит к округлению значения регулировки до этого количества цифр, так что полученное значение соответствует отображаемому, если “draw-value” равно TRUE при изменении значения. Если вы хотите принудительно округлить значение, когда “draw-value” равно FALSE, вы можете установить “round-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