From 9fab13452a26ed55c01047d4225f699f43bba20d Mon Sep 17 00:00:00 2001
From: Aylur <k.demeter@protonmail.com>
Date: Mon, 14 Oct 2024 16:45:03 +0000
Subject: feat: Astal3

---
 lib/astal/gtk3/src/widget/slider.vala | 71 +++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 lib/astal/gtk3/src/widget/slider.vala

(limited to 'lib/astal/gtk3/src/widget/slider.vala')

diff --git a/lib/astal/gtk3/src/widget/slider.vala b/lib/astal/gtk3/src/widget/slider.vala
new file mode 100644
index 0000000..466275b
--- /dev/null
+++ b/lib/astal/gtk3/src/widget/slider.vala
@@ -0,0 +1,71 @@
+public class Astal.Slider : Gtk.Scale {
+    [CCode (notify = false)]
+    public bool vertical {
+        get { return orientation == Gtk.Orientation.VERTICAL; }
+        set { orientation = value ? Gtk.Orientation.VERTICAL : Gtk.Orientation.HORIZONTAL; }
+    }
+
+    // emitted when the user drags the slider
+    public signal void dragged ();
+
+    construct {
+        draw_value = false;
+
+        if (adjustment == null)
+            adjustment = new Gtk.Adjustment(0,0,0,0,0,0);
+
+        if (max == 0 && min == 0) {
+            max = 1;
+        }
+
+        if (step == 0) {
+            step = 0.05;
+        }
+
+        notify["orientation"].connect(() => {
+            notify_property("vertical");
+        });
+
+        button_press_event.connect(() => { dragging = true; });
+        key_press_event.connect(() => { dragging = true; });
+        button_release_event.connect(() => { dragging = false; });
+        key_release_event.connect(() => { dragging = false; });
+        scroll_event.connect((event) => {
+            dragging = true;
+            if (event.delta_y > 0)
+                value -= step;
+            else
+                value += step;
+            dragging = false;
+        });
+
+        value_changed.connect(() => {
+            if (dragging)
+                dragged();
+        });
+    }
+
+    public bool dragging { get; private set; }
+
+    public double value {
+        get { return adjustment.value; }
+        set { if (!dragging) adjustment.value = value; }
+    }
+
+    public double min {
+        get { return adjustment.lower; }
+        set { adjustment.lower = value; }
+    }
+
+    public double max {
+        get { return adjustment.upper; }
+        set { adjustment.upper = value; }
+    }
+
+    public double step {
+        get { return adjustment.step_increment; }
+        set { adjustment.step_increment = value; }
+    }
+
+    // TODO: marks
+}
-- 
cgit v1.2.3


From 306e64998c1bf1fb997c1098ae92d6edfef31cd2 Mon Sep 17 00:00:00 2001
From: Aylur <k.demeter@protonmail.com>
Date: Wed, 23 Oct 2024 20:37:32 +0000
Subject: docs: astal3 and io comments

---
 lib/astal/gtk3/src/widget/slider.vala | 27 +++++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

(limited to 'lib/astal/gtk3/src/widget/slider.vala')

diff --git a/lib/astal/gtk3/src/widget/slider.vala b/lib/astal/gtk3/src/widget/slider.vala
index 466275b..97cfb69 100644
--- a/lib/astal/gtk3/src/widget/slider.vala
+++ b/lib/astal/gtk3/src/widget/slider.vala
@@ -1,12 +1,20 @@
+/**
+ * Subclass of [class@Gtk.Scale] which adds a signal and property for the drag state.
+ */
 public class Astal.Slider : Gtk.Scale {
+    /**
+     * Corresponds to [property@Gtk.Orientable :orientation].
+     */
     [CCode (notify = false)]
     public bool vertical {
         get { return orientation == Gtk.Orientation.VERTICAL; }
         set { orientation = value ? Gtk.Orientation.VERTICAL : Gtk.Orientation.HORIZONTAL; }
     }
 
-    // emitted when the user drags the slider
-    public signal void dragged ();
+    /**
+     * Emitted when the user drags the slider or uses keyboard arrows and its value changes.
+     */
+    public signal void dragged();
 
     construct {
         draw_value = false;
@@ -45,23 +53,38 @@ public class Astal.Slider : Gtk.Scale {
         });
     }
 
+    /**
+     * `true` when the user drags the slider or uses keyboard arrows.
+     */
     public bool dragging { get; private set; }
 
+    /**
+     * Value of this slider. Defaults to `0`.
+     */
     public double value {
         get { return adjustment.value; }
         set { if (!dragging) adjustment.value = value; }
     }
 
+    /**
+     * Minimum possible value of this slider. Defaults to `0`.
+     */
     public double min {
         get { return adjustment.lower; }
         set { adjustment.lower = value; }
     }
 
+    /**
+     * Maximum possible value of this slider. Defaults to `1`.
+     */
     public double max {
         get { return adjustment.upper; }
         set { adjustment.upper = value; }
     }
 
+    /**
+     * Size of step increments. Defaults to `0.05`.
+     */
     public double step {
         get { return adjustment.step_increment; }
         set { adjustment.step_increment = value; }
-- 
cgit v1.2.3