gi-gtk-3.0.11: Gtk bindings

CopyrightWill Thompson, Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (garetxe@gmail.com)
Safe HaskellNone
LanguageHaskell2010

GI.Gtk.Objects.LevelBar

Contents

Description

The LevelBar is a bar widget that can be used as a level indicator. Typical use cases are displaying the strength of a password, or showing the charge level of a battery.

Use levelBarSetValue to set the current value, and levelBarAddOffsetValue to set the value offsets at which the bar will be considered in a different state. GTK will add a few offsets by default on the level bar: LEVEL_BAR_OFFSET_LOW, LEVEL_BAR_OFFSET_HIGH and LEVEL_BAR_OFFSET_FULL, with values 0.25, 0.75 and 1.0 respectively.

Note that it is your responsibility to update preexisting offsets when changing the minimum or maximum value. GTK+ will simply clamp them to the new range.

Adding a custom offset on the bar

C code


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;
}

The default interval of values is between zero and one, but it’s possible to modify the interval using levelBarSetMinValue and levelBarSetMaxValue. The value will be always drawn in proportion to the admissible interval, i.e. a value of 15 with a specified interval between 10 and 20 is equivalent to a value of 0.5 with an interval between 0 and 1. When GTK_LEVEL_BAR_MODE_DISCRETE is used, the bar level is rendered as a finite number of separated blocks instead of a single one. The number of blocks that will be rendered is equal to the number of units specified by the admissible interval.

For instance, to build a bar rendered with five blocks, it’s sufficient to set the minimum value to 0 and the maximum value to 5 after changing the indicator mode to discrete.

GtkLevelBar was introduced in GTK+ 3.6.

GtkLevelBar as GtkBuildable

The GtkLevelBar implementation of the GtkBuildable interface supports a custom <offsets> element, which can contain any number of <offset> elements, each of which must have name and value attributes.

CSS nodes

plain code

levelbar[.discrete]
╰── trough
    ├── block.filled.level-name
    ┊
    ├── block.empty
    ┊

GtkLevelBar has a main CSS node with name levelbar and one of the style classes .discrete or .continuous and a subnode with name trough. Below the trough node are a number of nodes with name block and style class .filled or .empty. In continuous mode, there is exactly one node of each, in discrete mode, the number of filled and unfilled nodes corresponds to blocks that are drawn. The block.filled nodes also get a style class .level-name corresponding to the level for the current value.

In horizontal orientation, the nodes are always arranged from left to right, regardless of text direction.

Synopsis

Exported types

Methods

addOffsetValue

levelBarAddOffsetValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> Text

name: the name of the new offset

-> Double

value: the value for the new offset

-> m () 

Adds a new offset marker on self at the position specified by value. When the bar value is in the interval topped by value (or between value and LevelBar:max-value in case the offset is the last one on the bar) a style class named level-name will be applied when rendering the level bar fill. If another offset marker named name exists, its value will be replaced by value.

Since: 3.6

getInverted

levelBarGetInverted Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> m Bool

Returns: True if the level bar is inverted

Return the value of the LevelBar:inverted property.

Since: 3.8

getMaxValue

levelBarGetMaxValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> m Double

Returns: a positive value

Returns the value of the LevelBar:max-value property.

Since: 3.6

getMinValue

levelBarGetMinValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> m Double

Returns: a positive value

Returns the value of the LevelBar:min-value property.

Since: 3.6

getMode

levelBarGetMode Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> m LevelBarMode

Returns: a LevelBarMode

Returns the value of the LevelBar:mode property.

Since: 3.6

getOffsetValue

levelBarGetOffsetValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> Maybe Text

name: the name of an offset in the bar

-> m (Bool, Double)

Returns: True if the specified offset is found

Fetches the value specified for the offset marker name in self, returning True in case an offset named name was found.

Since: 3.6

getValue

levelBarGetValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> m Double

Returns: a value in the interval between LevelBar:min-value and LevelBar:max-value

Returns the value of the LevelBar:value property.

Since: 3.6

new

levelBarNew Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> m LevelBar

Returns: a LevelBar.

Creates a new LevelBar.

Since: 3.6

newForInterval

levelBarNewForInterval Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> Double

minValue: a positive value

-> Double

maxValue: a positive value

-> m LevelBar

Returns: a LevelBar

Utility constructor that creates a new LevelBar for the specified interval.

Since: 3.6

removeOffsetValue

levelBarRemoveOffsetValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> Maybe Text

name: the name of an offset in the bar

-> m () 

Removes an offset marker previously added with levelBarAddOffsetValue.

Since: 3.6

setInverted

levelBarSetInverted Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> Bool

inverted: True to invert the level bar

-> m () 

Sets the value of the LevelBar:inverted property.

Since: 3.8

setMaxValue

levelBarSetMaxValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> Double

value: a positive value

-> m () 

Sets the value of the LevelBar:max-value property.

You probably want to update preexisting level offsets after calling this function.

Since: 3.6

setMinValue

levelBarSetMinValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> Double

value: a positive value

-> m () 

Sets the value of the LevelBar:min-value property.

You probably want to update preexisting level offsets after calling this function.

Since: 3.6

setMode

data LevelBarSetModeMethodInfo Source #

Instances

((~) * signature (LevelBarMode -> m ()), MonadIO m, IsLevelBar a) => MethodInfo * LevelBarSetModeMethodInfo a signature Source # 

levelBarSetMode Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> LevelBarMode

mode: a LevelBarMode

-> m () 

Sets the value of the LevelBar:mode property.

Since: 3.6

setValue

data LevelBarSetValueMethodInfo Source #

Instances

((~) * signature (Double -> m ()), MonadIO m, IsLevelBar a) => MethodInfo * LevelBarSetValueMethodInfo a signature Source # 

levelBarSetValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsLevelBar a) 
=> a

self: a LevelBar

-> Double

value: a value in the interval between LevelBar:min-value and LevelBar:max-value

-> m () 

Sets the value of the LevelBar:value property.

Since: 3.6

Properties

inverted

data LevelBarInvertedPropertyInfo Source #

Instances

AttrInfo LevelBarInvertedPropertyInfo Source # 
type AttrOrigin LevelBarInvertedPropertyInfo Source # 
type AttrLabel LevelBarInvertedPropertyInfo Source # 
type AttrGetType LevelBarInvertedPropertyInfo Source # 
type AttrBaseTypeConstraint LevelBarInvertedPropertyInfo Source # 
type AttrSetTypeConstraint LevelBarInvertedPropertyInfo Source # 
type AttrAllowedOps LevelBarInvertedPropertyInfo Source # 

maxValue

data LevelBarMaxValuePropertyInfo Source #

Instances

AttrInfo LevelBarMaxValuePropertyInfo Source # 
type AttrOrigin LevelBarMaxValuePropertyInfo Source # 
type AttrLabel LevelBarMaxValuePropertyInfo Source # 
type AttrGetType LevelBarMaxValuePropertyInfo Source # 
type AttrBaseTypeConstraint LevelBarMaxValuePropertyInfo Source # 
type AttrSetTypeConstraint LevelBarMaxValuePropertyInfo Source # 
type AttrAllowedOps LevelBarMaxValuePropertyInfo Source # 

minValue

data LevelBarMinValuePropertyInfo Source #

Instances

AttrInfo LevelBarMinValuePropertyInfo Source # 
type AttrOrigin LevelBarMinValuePropertyInfo Source # 
type AttrLabel LevelBarMinValuePropertyInfo Source # 
type AttrGetType LevelBarMinValuePropertyInfo Source # 
type AttrBaseTypeConstraint LevelBarMinValuePropertyInfo Source # 
type AttrSetTypeConstraint LevelBarMinValuePropertyInfo Source # 
type AttrAllowedOps LevelBarMinValuePropertyInfo Source # 

mode

data LevelBarModePropertyInfo Source #

Instances

AttrInfo LevelBarModePropertyInfo Source # 
type AttrOrigin LevelBarModePropertyInfo Source # 
type AttrLabel LevelBarModePropertyInfo Source # 
type AttrGetType LevelBarModePropertyInfo Source # 
type AttrBaseTypeConstraint LevelBarModePropertyInfo Source # 
type AttrSetTypeConstraint LevelBarModePropertyInfo Source # 
type AttrAllowedOps LevelBarModePropertyInfo Source # 

value

data LevelBarValuePropertyInfo Source #

Instances

AttrInfo LevelBarValuePropertyInfo Source # 
type AttrOrigin LevelBarValuePropertyInfo Source # 
type AttrLabel LevelBarValuePropertyInfo Source # 
type AttrGetType LevelBarValuePropertyInfo Source # 
type AttrBaseTypeConstraint LevelBarValuePropertyInfo Source # 
type AttrSetTypeConstraint LevelBarValuePropertyInfo Source # 
type AttrAllowedOps LevelBarValuePropertyInfo Source # 

setLevelBarValue :: (MonadIO m, IsLevelBar o) => o -> Double -> m () Source #

Signals

offsetChanged