252 lines
9.0 KiB
Swift
252 lines
9.0 KiB
Swift
//
|
||
// LevelBar.swift
|
||
// Adwaita
|
||
//
|
||
// Created by auto-generation on 26.10.24.
|
||
//
|
||
|
||
import CAdw
|
||
import LevenshteinTransformations
|
||
|
||
/// `GtkLevelBar` is a 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 [method@Gtk.LevelBar.set_value] to set the current value, and
|
||
/// [method@Gtk.LevelBar.add_offset_value] 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: %GTK_LEVEL_BAR_OFFSET_LOW,
|
||
/// %GTK_LEVEL_BAR_OFFSET_HIGH and %GTK_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
|
||
/// 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-width: 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 [method@Gtk.LevelBar.set_min_value] and
|
||
/// [method@Gtk.LevelBar.set_max_value]. 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 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
|
||
///
|
||
/// ```
|
||
/// 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.
|
||
///
|
||
/// # Accessibility
|
||
///
|
||
/// `GtkLevelBar` uses the %GTK_ACCESSIBLE_ROLE_METER role.
|
||
public struct LevelBar: AdwaitaWidget {
|
||
|
||
/// Additional update functions for type extensions.
|
||
var updateFunctions: [(ViewStorage, WidgetData, Bool) -> Void] = []
|
||
/// Additional appear functions for type extensions.
|
||
var appearFunctions: [(ViewStorage, WidgetData) -> Void] = []
|
||
|
||
/// The accessible role of the given `GtkAccessible` implementation.
|
||
///
|
||
/// The accessible role cannot be changed once set.
|
||
var accessibleRole: String?
|
||
/// Whether the `GtkLeveBar` is inverted.
|
||
///
|
||
/// Level bars normally grow from top to bottom or left to right.
|
||
/// Inverted level bars grow in the opposite direction.
|
||
var inverted: Bool?
|
||
/// Determines the maximum value of the interval that can be displayed by the bar.
|
||
var maxValue: Double?
|
||
/// Determines the minimum value of the interval that can be displayed by the bar.
|
||
var minValue: Double?
|
||
/// Determines the currently filled value of the level bar.
|
||
var value: Double?
|
||
/// Emitted when an offset specified on the bar changes value.
|
||
///
|
||
/// This typically is the result of a [method@Gtk.LevelBar.add_offset_value]
|
||
/// call.
|
||
///
|
||
/// The signal supports detailed connections; you can connect to the
|
||
/// detailed signal "changed::x" in order to only receive callbacks when
|
||
/// the value of offset "x" changes.
|
||
var offsetChanged: (() -> Void)?
|
||
|
||
/// Initialize `LevelBar`.
|
||
public init() {
|
||
}
|
||
|
||
/// The view storage.
|
||
/// - Parameters:
|
||
/// - modifiers: Modify views before being updated.
|
||
/// - type: The view render data type.
|
||
/// - Returns: The view storage.
|
||
public func container<Data>(data: WidgetData, type: Data.Type) -> ViewStorage where Data: ViewRenderData {
|
||
let storage = ViewStorage(gtk_level_bar_new()?.opaque())
|
||
for function in appearFunctions {
|
||
function(storage, data)
|
||
}
|
||
update(storage, data: data, updateProperties: true, type: type)
|
||
|
||
return storage
|
||
}
|
||
|
||
/// Update the stored content.
|
||
/// - Parameters:
|
||
/// - storage: The storage to update.
|
||
/// - modifiers: Modify views before being updated
|
||
/// - updateProperties: Whether to update the view's properties.
|
||
/// - type: The view render data type.
|
||
public func update<Data>(_ storage: ViewStorage, data: WidgetData, updateProperties: Bool, type: Data.Type) where Data: ViewRenderData {
|
||
if let offsetChanged {
|
||
storage.connectSignal(name: "offset-changed", argCount: 1) {
|
||
offsetChanged()
|
||
}
|
||
}
|
||
storage.modify { widget in
|
||
|
||
if let inverted, updateProperties, (storage.previousState as? Self)?.inverted != inverted {
|
||
gtk_level_bar_set_inverted(widget, inverted.cBool)
|
||
}
|
||
if let maxValue, updateProperties, (storage.previousState as? Self)?.maxValue != maxValue {
|
||
gtk_level_bar_set_max_value(widget, maxValue)
|
||
}
|
||
if let minValue, updateProperties, (storage.previousState as? Self)?.minValue != minValue {
|
||
gtk_level_bar_set_min_value(widget, minValue)
|
||
}
|
||
if let value, updateProperties, (storage.previousState as? Self)?.value != value {
|
||
gtk_level_bar_set_value(widget, value)
|
||
}
|
||
|
||
|
||
|
||
}
|
||
for function in updateFunctions {
|
||
function(storage, data, updateProperties)
|
||
}
|
||
if updateProperties {
|
||
storage.previousState = self
|
||
}
|
||
}
|
||
|
||
/// The accessible role of the given `GtkAccessible` implementation.
|
||
///
|
||
/// The accessible role cannot be changed once set.
|
||
public func accessibleRole(_ accessibleRole: String?) -> Self {
|
||
var newSelf = self
|
||
newSelf.accessibleRole = accessibleRole
|
||
return newSelf
|
||
}
|
||
|
||
/// Whether the `GtkLeveBar` is inverted.
|
||
///
|
||
/// Level bars normally grow from top to bottom or left to right.
|
||
/// Inverted level bars grow in the opposite direction.
|
||
public func inverted(_ inverted: Bool? = true) -> Self {
|
||
var newSelf = self
|
||
newSelf.inverted = inverted
|
||
return newSelf
|
||
}
|
||
|
||
/// Determines the maximum value of the interval that can be displayed by the bar.
|
||
public func maxValue(_ maxValue: Double?) -> Self {
|
||
var newSelf = self
|
||
newSelf.maxValue = maxValue
|
||
return newSelf
|
||
}
|
||
|
||
/// Determines the minimum value of the interval that can be displayed by the bar.
|
||
public func minValue(_ minValue: Double?) -> Self {
|
||
var newSelf = self
|
||
newSelf.minValue = minValue
|
||
return newSelf
|
||
}
|
||
|
||
/// Determines the currently filled value of the level bar.
|
||
public func value(_ value: Double?) -> Self {
|
||
var newSelf = self
|
||
newSelf.value = value
|
||
return newSelf
|
||
}
|
||
|
||
/// Emitted when an offset specified on the bar changes value.
|
||
///
|
||
/// This typically is the result of a [method@Gtk.LevelBar.add_offset_value]
|
||
/// call.
|
||
///
|
||
/// The signal supports detailed connections; you can connect to the
|
||
/// detailed signal "changed::x" in order to only receive callbacks when
|
||
/// the value of offset "x" changes.
|
||
public func offsetChanged(_ offsetChanged: @escaping () -> Void) -> Self {
|
||
var newSelf = self
|
||
newSelf.offsetChanged = offsetChanged
|
||
return newSelf
|
||
}
|
||
|
||
}
|