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

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

GTK_LEVEL_BAR_OFFSET_LOW

#define GTK_LEVEL_BAR_OFFSET_LOW  "low"

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

С версии: 3.6

GTK_LEVEL_BAR_OFFSET_HIGH

#define GTK_LEVEL_BAR_OFFSET_HIGH "high"

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

С версии: 3.6

GTK_LEVEL_BAR_OFFSET_FULL

#define GTK_LEVEL_BAR_OFFSET_FULL "full"

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

С версии: 3.20

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

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

С версии: 3.6

структура GtkLevelBar

struct GtkLevelBar;

Свойство “inverted”

  “inverted”                 gboolean

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

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

Значение по умолчанию: ЛОЖЬ

С версии: 3.8

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

  “max-value”                gdouble

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

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

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

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

С версии: 3.6

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

  “min-value”                gdouble

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

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

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

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

С версии: 3.6

Свойство “mode”

  “mode”                     GtkLevelBarMode

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

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

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

С версии: 3.6

Свойство “value”

  “value”                    gdouble

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

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

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

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

С версии: 3.6

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

  “min-block-height”         gint

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

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

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

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

С версии: 3.6

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

  “min-block-width”          gint

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

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

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

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

С версии: 3.6

Сигнал “offset-changed”

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

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

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

Флаги: Содержит детали

С версии: 3.6