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"

Имя, используемое для стандартного нижнего смещения, включенного в 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

struct GtkLevelBar

struct GtkLevelBar;

Свойство “inverted”

  “inverted”                 gboolean

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

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

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

С версии: 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