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 был введён в GTK+ 3.6.

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 количество узлов filled и unfilled соответствует отображаемым блокам. Узлы block.filled также получают класс стиля .level-name, соответствующий уровню для текущего значения.

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

GTK_LEVEL_BAR_OFFSET_LOW

#define GTK_LEVEL_BAR_OFFSET_LOW  "low"

Имя, используемое для отметки смещения «минимальное» (low), включённой в GtkLevelBar.

С: 3.6

GTK_LEVEL_BAR_OFFSET_HIGH

#define GTK_LEVEL_BAR_OFFSET_HIGH "high"

Имя, используемое для отметки смещения «максимальное» (high), включённой в GtkLevelBar.

С: 3.6

GTK_LEVEL_BAR_OFFSET_FULL

#define GTK_LEVEL_BAR_OFFSET_FULL "full"

Имя, используемое для отметки смещения «полное» (full), включённой в GtkLevelBar.

С: 3.20

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

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

С: 3.6

структура GtkLevelBar

struct GtkLevelBar;

Свойство “inverted”

  “inverted”                 gboolean

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

Владелец: GtkLevelBar

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

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

С: 3.8

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

  “max-value”                double

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

Владелец: GtkLevelBar

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

Разрешенные значения: >= 0

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

С: 3.6

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

  “min-value”                double

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

Владелец: GtkLevelBar

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

Разрешенные значения: >= 0

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

С: 3.6

Свойство “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

С: 3.6

Свойство “value”

  “value”                    double

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

Владелец: GtkLevelBar

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

Разрешенные значения: >= 0

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

С: 3.6

Свойство стиля “min-block-height”

  “min-block-height”         int

Свойство стиля min-block-height определяет минимальную высоту блоков, заполняющих виджет GtkLevelBar.

Владелец: GtkLevelBar

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

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

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

С версии: 3.6

Свойство стиля “min-block-width”

  “min-block-width”          int

Свойство стиля min-block-width определяет минимальную ширину блоков, заполняющих виджет GtkLevelBar.

Владелец: GtkLevelBar

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

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

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

С версии: 3.6

Сигнал “offset-changed”

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

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

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

Флаги: Подробности

С версии: 3.6