GtkScale

GtkScaleFormatValueFunc ()

char *
(*GtkScaleFormatValueFunc) (GtkScale *scale,
                            double value,
                            gpointer user_data);

gtk_scale_new ()

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

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

gtk_scale_new_with_range ()

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

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

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

gtk_scale_set_format_value_func ()

void
gtk_scale_set_format_value_func (GtkScale *scale,
                                 GtkScaleFormatValueFunc func,
                                 gpointer user_data,
                                 GDestroyNotify destroy_notify);

func позволяет изменить способ отображения значения шкалы. Указанная функция вернёт выделенную строку, представляющую value . Эта строка затем будет использована для отображения значения шкалы.

Если NULL передаётся в качестве func , значение будет отображено самостоятельно, округлённое в соответствии со значением свойства “digits”.

gtk_scale_set_digits ()

void
gtk_scale_set_digits (GtkScale *scale,
                      int digits);

Устанавливает количество десятичных знаков, отображаемых в значении. Также вызывает округление значения регулировки до этого числа знаков, чтобы полученное значение соответствовало отображаемому, если “draw-value” равно TRUE при изменении значения. Если вы хотите принудительно округлить значение, когда “draw-value” равно FALSE, вы можете установить “round-digits” вместо этого.

Обратите внимание, что округление до небольшого числа знаков может помешать плавному автоматическому прокручиванию, встроенному в GtkScale. В качестве альтернативы можно использовать gtk_scale_set_format_value_func() для самостоятельного форматирования отображаемого значения.

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 (по умолчанию), шкала выделит часть желоба между началом (нижняя или левая сторона) и текущим значением.

gtk_scale_set_value_pos ()

void
gtk_scale_set_value_pos (GtkScale *scale,
                         GtkPositionType pos);

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

gtk_scale_get_digits ()

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

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

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, используемый для отображения шкалы. Возвращаемый объект принадлежит шкале, поэтому вызывающей стороне не нужно его освобождать.

gtk_scale_get_layout_offsets ()

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

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

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

gtk_scale_add_mark ()

void
gtk_scale_add_mark (GtkScale *scale,
                    double value,
                    GtkPositionType position,
                    const char *markup);

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

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

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

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

gtk_scale_clear_marks ()

void
gtk_scale_clear_marks (GtkScale *scale);

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