GtkLevelBar

Добавление пользовательского смещения на шкале

По умолчанию диапазон значений находится между нулём и единицей, но его можно изменить с помощью gtk_level_bar_set_min_value() и gtk_level_bar_set_max_value(). Значение всегда будет отображаться пропорционально допустимому диапазону, т. е. значение 15 при заданном диапазоне от 10 до 20 эквивалентно значению 0,5 при диапазоне от 0 до 1. Когда используется GTK_LEVEL_BAR_MODE_DISCRETE, уровень шкалы отображается как конечное количество отдельных блоков вместо одного цельного. Количество блоков, которые будут отображены, равно количеству единиц, указанных в допустимом диапазоне.

Например, чтобы создать шкалу, отображающую пять блоков, достаточно установить минимальное значение в 0 и максимальное в 5 после изменения режима индикатора на дискретный.

GtkLevelBar как GtkBuildable

Реализация GtkLevelBar интерфейса GtkBuildable поддерживает пользовательский элемент <offsets>, который может содержать любое количество элементов <offset>, каждый из которых должен иметь атрибуты name и value.

Узлы CSS

static GtkWidget *
create_level_bar (void)
{
  GtkWidget *widget;
  GtkLevelBar *bar;

  widget = gtk_level_bar_new ();
  bar = GTK_LEVEL_BAR (widget);

  // This changes the value of the default low offset

  gtk_level_bar_add_offset_value (bar,
                                  GTK_LEVEL_BAR_OFFSET_LOW,
                                  0.10);

  // This adds a new offset to the bar; the application will
  // be able to change its color CSS like this:
  //
  // levelbar block.my-offset {
  //   background-color: magenta;
  //   border-style: solid;
  //   border-color: black;
  //   border-style: 1px;
  // }

  gtk_level_bar_add_offset_value (bar, "my-offset", 0.60);

  return widget;
}

GtkLevelBar имеет основной узел CSS с именем levelbar и одним из классов стиля .discrete или .continuous и подузлом с именем trough. Под узлом trough находится ряд узлов с именем block и классами стиля .filled или .empty. В режиме continuous существует ровно один узел каждого типа, в режиме discrete количество заполненных и незаполненных узлов соответствует отображаемым блокам. Узлы block.filled также получают класс стиля .level-name, соответствующий уровню для текущего значения.

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

Доступность

GtkLevelBar использует роль GTK_ACCESSIBLE_ROLE_METER.

GTK_LEVEL_BAR_OFFSET_LOW

#define GTK_LEVEL_BAR_OFFSET_LOW  "low"

Имя, используемое для стандартного смещения минимума, включённого в GtkLevelBar.

GTK_LEVEL_BAR_OFFSET_HIGH

#define GTK_LEVEL_BAR_OFFSET_HIGH "high"

Имя, используемое для стандартного смещения максимума, включённого в GtkLevelBar.

GTK_LEVEL_BAR_OFFSET_FULL

#define GTK_LEVEL_BAR_OFFSET_FULL "full"

Имя, используемое для стандартного смещения полного диапазона, включённого в GtkLevelBar.

перечисление GtkLevelBarMode

Описывает, как содержимое GtkLevelBar должно отображаться. Обратите внимание, что это перечисление может быть расширено дополнительными режимами в будущем.

GtkLevelBar

typedef struct _GtkLevelBar GtkLevelBar;

Свойство “inverted”

  “inverted”                 gboolean

Шкалы уровня обычно растут сверху вниз или слева направо. Перевёрнутые шкалы уровня растут в противоположном направлении.

Владелец: GtkLevelBar

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

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

Свойство “max-value”

  “max-value”                double

Свойство “max-value” определяет максимальное значение диапазона, который может отображаться шкалой.

Владелец: GtkLevelBar

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

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

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

Свойство “min-value”

  “min-value”                double

Свойство “min-value” определяет минимальное значение диапазона, который может отображаться шкалой.

Владелец: GtkLevelBar

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

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

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

Свойство “mode”

  “mode”                     GtkLevelBarMode

Свойство “mode” определяет способ, которым GtkLevelBar интерпретирует свойства значения для отрисовки области заполнения уровня. В частности, когда значение равно GTK_LEVEL_BAR_MODE_CONTINUOUS, GtkLevelBar нарисует один блок, представляющий текущее значение в этой области; когда значение равно GTK_LEVEL_BAR_MODE_DISCRETE, виджет нарисует последовательность отдельных блоков, заполняющих область отрисовки, причём количество блоков будет равно количеству единиц, разделяющих целые округлений “min-value” и “max-value”.

Владелец: GtkLevelBar

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

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

Свойство “value”

  “value”                    double

Свойство “value” определяет текущее заполненное значение шкалы уровня.

Владелец: GtkLevelBar

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

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

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

Сигнал “offset-changed”

void
user_function (GtkLevelBar *self,
               char        *name,
               gpointer     user_data)

Используется при изменении значения смещения на шкале в результате вызова gtk_level_bar_add_offset_value().

Сигнал поддерживает подробные соединения; можно подключиться к детализированному сигналу "changed::x", чтобы получать обратные вызовы только при изменении значения смещения "x".

Флаги: Имеет детали