libui_paradise 0.3.9 → 0.4.13

data/lib/libui_paradise/fiddle/fiddle.rb

@@ -8,8 +8,8 @@
 # really not recommended to do this.
 #
 # A cleaner solution would be to modify just in-place, such as via
-# refinements, but I don't quite like the syntax of refinements,
-# so I opted for the simpler toplevel modification instead.
+# refinements, but I don't quite like the syntax of refinements, so
+# I opted for the simpler toplevel modification instead.
 # =========================================================================== #
 # require 'libui_paradise/fiddle/fiddle.rb'
 # =========================================================================== #
@@ -17,50 +17,60 @@ module Fiddle
 
 class Pointer # === Fiddle::Pointer
 
-  require 'libui_paradise/extensions/toplevel_counters.rb'
+  require 'libui_paradise/toplevel_methods/hash_fiddle_pointer_widgets.rb'
+  require 'libui_paradise/toplevel_methods/toplevel_counters.rb'
 
   # ========================================================================= #
-  # === enable                                                   (enable tag)
+  # === available_pointers?
   # ========================================================================= #
-  def enable(&block)
+  def available_pointers?
+    ::LibuiParadise.hash_fiddle_pointer_widgets?
+  end; alias main_hash?                   available_pointers? # === main_hash?
+       alias hash_fiddle_pointer_widgets? available_pointers? # === hash_fiddle_pointer_widgets?
+
+  # ========================================================================= #
+  # === clear
+  # ========================================================================= #
+  def clear(
+      current_widget = available_pointers?[self.object_id] # This will be an Array.
+    )
+    _pointer = current_widget.first # Not used currently in this method.
+    type     = current_widget.last
+
     object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    type = hash[object_id].last # The last entry contains the type.
+    hash = hash_fiddle_pointer_widgets?
+    if type.nil?
+      type = hash[object_id].last # This should be :grid. But it is not used here.
+    end
     case type
     # ======================================================================= #
-    # === :button
+    # === :multiline_entry
     # ======================================================================= #
-    when :button
-      LibUI.control_enable(self)
+    when :multiline_entry
+      ::LibUI.multiline_entry_set_text(self, '')
+    # ======================================================================= #
+    # === :combobox
+    #
+    # This currently does not work; it depends on libui-ng, which has not
+    # yet been added completely.
+    # ======================================================================= #
+    when :combobox
+    #   LibUI.multiline_entry_set_text(
+    #     this_widget,
+    #     display_this_text.to_s
+    #   )
     else
-      e 'Not registered type in .enable(): '+type.to_s
+      puts "Unhandled case in clear(): "\
+           "#{type}"
     end
   end
 
   # ========================================================================= #
-  # === on_changed
-  #
-  # The idea for this method is to respond to on-changed events, in
-  # particular on a spinbox. Currently it is enabled for a few
-  # widgets, including :entry. This may be expanded at a later time
-  # to add on-changed support for more widgets.
-  #
-  # For a combobox we may have to use this code:
-  #
-  #   LibUI.combobox_on_selected
-  #     UI.spinbox_on_changed(self, spinbox_changed_callback, nil)
-  #   end
-  #
-  # Be sure to pass the proc object into the method, in a block.
-  #
-  # Usage examples:
-  #
-  #   text_entry.on_changed { text_changed_callback }
-  #   slider.on_changed { slider_changed_callback }
-  #
+  # === is_read_only
   # ========================================================================= #
-  def on_changed(&block)
-    current_widget = available_pointers?[self.object_id] # This will be an Array.
+  def is_read_only(
+      current_widget = available_pointers?[self.object_id] # This will be an Array.
+    )
     _pointer = current_widget.first # Not used currently in this method.
     type     = current_widget.last
     case type
@@ -68,121 +78,164 @@ class Pointer # === Fiddle::Pointer
     # === :entry
     # ======================================================================= #
     when :entry
-      LibUI.entry_on_changed(self, block.call, nil)
+      ::LibUI.entry_set_read_only(self, 1)
     # ======================================================================= #
     # === :multiline_entry
     # ======================================================================= #
     when :multiline_entry
-      LibUI.multiline_entry_on_changed(self, block.call, nil)
-    # ======================================================================= #
-    # === :spinbox
-    # ======================================================================= #
-    when :spinbox
-      LibUI.spinbox_on_changed(self, block.call, nil)
-    # ======================================================================= #
-    # === :slider
-    #
-    # This is for a slider bar.
-    # ======================================================================= #
-    when :slider
-      LibUI.slider_on_changed(self, block.call, nil)
-    # ======================================================================= #
-    # === :colour_button
-    # ======================================================================= #
-    when :colour_button
-      LibUI.color_button_on_changed(self, block.call, nil)
-    # ======================================================================= #
-    # === :combobox
-    # ======================================================================= #
-    when :combobox
-      LibUI.combobox_on_selected(self, block.call, nil)
+      ::LibUI.multiline_entry_set_read_only(self, 1)
     else
-      e 'Not registered type in .on_changed(): '+type.to_s
+      pp 'The caller in is_read_only() will be shown next:'
+      puts
+      pp caller()
+      puts
+      puts "#{type} (class #{type.class}) is not yet implemented in .padded=."
+      puts
     end
-  end
+  end; alias readonly                           is_read_only # === readonly
+       alias the_user_may_not_modify_this_entry is_read_only # === the_user_may_not_modify_this_entry
 
   # ========================================================================= #
-  # === fraction=
-  #
-  # This is mostly a wrapper to reach ruby-gtk3 compatibility.
+  # === new_row
   # ========================================================================= #
-  def fraction=(i = '')
-    i = i * 100
-    set_value(i)
+  def new_row
+    ::LibuiParadise.new_row
   end
 
   # ========================================================================= #
-  # === set_text
-  #
-  # This method can be used to set the text of a particular libui-widget,
-  # in particular entries.
+  # === right                                                     (right tag)
   # ========================================================================= #
-  def set_text(
-      display_this_text = '', # This is the text that will be used.
-      type              = nil
+  def right(
+      widget,
+      left  = LibuiParadise.counter_left?,
+      top   = LibuiParadise.counter_top?,
+      xspan = 1,
+      yspan = 1
     )
     object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    this_widget = hash[object_id].first
-    if type.nil?
-      type = hash[object_id].last # This should be :grid. But it is not used here.
+    hash = hash_fiddle_pointer_widgets?
+    type = hash[object_id].last # The last entry contains the type.
+    case left
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default
+      left = LibuiParadise.counter_left?
     end
-    case type
+    case top
     # ======================================================================= #
-    # === :new_progress_bar
+    # === :default
     # ======================================================================= #
-    when :new_progress_bar
-      # This currently does nothing.
+    when :default
+      top = LibuiParadise.counter_top?
+    end
+    case type
     # ======================================================================= #
-    # === :multiline_entry
-    #
-    # This is a text-view widget actually.
+    # === :vbox
     # ======================================================================= #
-    when :multiline_entry
-      LibUI.multiline_entry_set_text(
-        this_widget,
-        display_this_text.to_s
-      )
+    when :vbox
+      add(widget)
     # ======================================================================= #
-    # === :text
+    # === :grid
     # ======================================================================= #
-    when :text,
-         :label
-      LibUI.label_set_text(
-        this_widget,
-        display_this_text.to_s
+    when :grid
+      hash_grid(
+        widget,
+        {
+          left:    left,
+          top:     top,
+          xspan:   xspan,
+          yspan:   yspan,
+          hexpand: 0,
+          halign:  0,
+          vexpand: 0,
+          valign:  0
+        }
       )
+      # ===================================================================== #
+      # And we must add a new row next:
+      # ===================================================================== #
+      LibuiParadise.new_row
+    else
+    end
+  end
+
+  # ========================================================================= #
+  # === ui_grid_append
+  #
+  # This method can be used to append onto a grid in LibUI.
+  #
+  # Usage example:
+  #
+  #   grid.grid_append(text('Right'), 1, 0, 1, 1, 0, 0.5, 1, 0)
+  #
+  # ========================================================================= #
+  def ui_grid_append(
+      widget_to_append,
+      left    = LibuiParadise.left_counter?,
+      top     = LibuiParadise.top_counter?,
+      xspan   = 1,
+      yspan   = 1,     # 
+      hexpand = 0, # A "boolean". 0 means false here.
+      halign  = 0,
+      vexpand = 0, # A "boolean". 0 means false here, 1 means true, and thus "do expand".
+      valign  = 0
+    )
     # ======================================================================= #
-    # === :textview
+    # The signature in Go is:
+    #
+    #   Append(child Control, left, top int, xspan, yspan int, hexpand bool, halign Align, vexpand bool, valign Align)
+    #
     # ======================================================================= #
-    when :textview
-      LibUI.multiline_entry_set_text(
-        this_widget,
-        display_this_text.to_s
-      )
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    this_widget = hash[object_id].first
+    _type       = hash[object_id].last # This should be :grid. But it is not used here.
+    if (left == LibuiParadise.left_counter?)
+      LibuiParadise.increment_the_left_counter
+    end
     # ======================================================================= #
-    # === :entry
+    # left, top, xspan, yspan, hexpand, halign, vexpand, valign
+    #  0,    0,    2,     1,      0,      0,       1,      0
     # ======================================================================= #
-    when :entry
-      LibUI.entry_set_text(
-        this_widget,
-        display_this_text.to_s
-      )
+    LibUI.grid_append(
+      this_widget,
+      widget_to_append, # This is the widget that will be added (appended) onto the grid-widget.
+      left,
+      top,
+      xspan,
+      yspan,
+      hexpand,
+      halign,
+      vexpand,
+      valign
+    )
+  end; alias grid_append ui_grid_append # === grid_append
+
+  # ========================================================================= #
+  # === show_then_main_then_quit
+  #
+  # This method ultimately combines three other method calls, or even
+  # four, since as of December 2023.
+  #
+  # The argument that this method accepts is the main window.
+  # ========================================================================= #
+  def show_then_main_then_quit(
+      optional_widget = nil
+    )
     # ======================================================================= #
-    # === :search_entry
-    #
-    # This is specifically for a search-entry.
+    # First handle non-nil arguments given.
     # ======================================================================= #
-    when :search_entry
-      LibUI.entry_set_text(
-        this_widget,
-        display_this_text.to_s
-      )
-    else
-      puts 'Unhandled case in set_text(): '+
-           type.to_s
+    if optional_widget
+      self << optional_widget
     end
-  end; alias set_content set_text # === set_content
+    ::LibUI.control_show(self)
+    main_then_quit
+  end; alias elegant_exit           show_then_main_then_quit # === elegant_exit
+       alias complex_finalizer      show_then_main_then_quit # === complex_finalizer
+       alias intelligent_close_down show_then_main_then_quit # === intelligent_close_down
+       alias intelligent_quit       show_then_main_then_quit # === intelligent_quit
+       alias intelligent_exit       show_then_main_then_quit # === intelligent_exit
 
   # ========================================================================= #
   # === text?
@@ -194,7 +247,7 @@ class Pointer # === Fiddle::Pointer
       type = nil
     )
     object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
+    hash = hash_fiddle_pointer_widgets?
     if type.nil?
       # ===================================================================== #
       # In this case we must determine the type in use.
@@ -205,6 +258,11 @@ class Pointer # === Fiddle::Pointer
     end
     case type
     # ======================================================================= #
+    # === :label
+    # ======================================================================= #
+    when :label
+      return LibUI.label_text(self).to_s
+    # ======================================================================= #
     # === :new_progress_bar
     #
     # This is actually a progress-bar.
@@ -229,384 +287,384 @@ class Pointer # === Fiddle::Pointer
       return LibUI.entry_text(self).to_s
     end
   end; alias buffer?   text? # === buffer?
-       alias selected? text? # === selected?
        alias value?    text? # === value?
+       alias selected? text? # === selected?
 
   # ========================================================================= #
-  # === set_value
-  #
-  # This method has initially been created to assign a value to a
-  # spinbutton. That way the following API is made possible:
-  #
-  #   spinbutton.set_value(42)
-  #
+  # === on_toggled
   # ========================================================================= #
-  def set_value(
-      new_value
-    )
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    this_widget = hash[object_id].first
-    type = hash[object_id].last
+  def on_toggled(&block)
+    current_widget = available_pointers?[self.object_id] # This will be an Array.
+    _pointer = current_widget.first # Not used currently in this method.
+    type     = current_widget.last
     case type
     # ======================================================================= #
-    # === :new_progress_bar
-    #
-    # This is actually a progress-bar.
-    # ======================================================================= #
-    when :new_progress_bar,
-         :progress_bar
-      LibUI.progress_bar_set_value(this_widget, new_value.to_i)
-    # ======================================================================= #
-    # === :spinbox
+    # === :checkbox
     # ======================================================================= #
-    when :spinbox
-      LibUI.spinbox_set_value(
-        this_widget,
-        new_value.to_i # Must be an Integer.
-      )
+    when :checkbox
+      ::LibUI.checkbox_on_toggled(self, block.call, nil)
     else
-      e 'Not registered type: '+type.to_s
+      e 'Not yet added here: '+type.to_s
     end
-  end; alias value=          set_value # === value=
-       alias start_position= set_value # === start_position=
+  end
 
   # ========================================================================= #
-  # === left                                                       (left tag)
+  # === on_changed
+  #
+  # The idea for this method is to respond to on-changed events, in
+  # particular on a spinbox. Currently it is enabled for a few
+  # widgets, including :entry. This may be expanded at a later time
+  # to add on-changed support for more widgets.
+  #
+  # For a combobox we may have to use this code:
+  #
+  #   LibUI.combobox_on_selected
+  #     UI.spinbox_on_changed(self, spinbox_changed_callback, nil)
+  #   end
+  #
+  # Be sure to pass the proc object into the method, in a block.
+  #
+  # Usage examples:
+  #
+  #   text_entry.on_changed { text_changed_callback }
+  #   slider.on_changed { slider_changed_callback }
+  #
   # ========================================================================= #
-  def left(
-      widget,
-      left  = LibuiParadise.counter_left?,
-      top   = LibuiParadise.counter_top?,
-      xspan = 1,
-      yspan = 1
-    )
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    type = hash[object_id].last # The last entry contains the type.
-    case left
+  def on_changed(&block)
+    current_widget = available_pointers?[self.object_id] # This will be an Array.
+    _pointer = current_widget.first # Not used currently in this method.
+    type     = current_widget.last
+    case type
     # ======================================================================= #
-    # === :default
+    # === :entry
     # ======================================================================= #
-    when :default
-      left = LibuiParadise.counter_left?
-    end
-    case top
+    when :entry
+      ::LibUI.entry_on_changed(self, block.call, nil)
     # ======================================================================= #
-    # === :default
+    # === :multiline_entry
     # ======================================================================= #
-    when :default
-      top = LibuiParadise.counter_top?
-    end
-    case type
+    when :multiline_entry
+      ::LibUI.multiline_entry_on_changed(self, block.call, nil)
     # ======================================================================= #
-    # === :vbox
+    # === :spinbox
     # ======================================================================= #
-    when :vbox
-      add(widget)
+    when :spinbox
+      ::LibUI.spinbox_on_changed(self, block.call, nil)
     # ======================================================================= #
-    # === :grid
+    # === :slider
+    #
+    # This is for a slider bar.
     # ======================================================================= #
-    when :grid
-      hash_grid(
-        widget,
-        {
-          left:    left,
-          top:     top,
-          xspan:   xspan,
-          yspan:   yspan,
-          hexpand: 0,
-          halign:  0,
-          vexpand: 0,
-          valign:  0
-        }
-      )
-      LibuiParadise.counter_left += 1
+    when :slider
+      ::LibUI.slider_on_changed(self, block.call, nil)
+    # ======================================================================= #
+    # === :colour_button
+    # ======================================================================= #
+    when :colour_button
+      ::LibUI.color_button_on_changed(self, block.call, nil)
+    # ======================================================================= #
+    # === :combobox
+    # ======================================================================= #
+    when :combobox
+      ::LibUI.combobox_on_selected(self, block.call, nil)
     else
+      e 'Not registered type in .on_changed(): '+type.to_s
     end
   end
 
   # ========================================================================= #
-  # === right                                                     (right tag)
+  # === append                                          (append tag, add tag)
+  #
+  # This is simply a wrapper over LibUI.box_append().
   # ========================================================================= #
-  def right(
-      widget,
-      left  = LibuiParadise.counter_left?,
-      top   = LibuiParadise.counter_top?,
-      xspan = 1,
-      yspan = 1
+  def append(
+      this_widget,
+      padding_to_use = 1,
+      *remaining_arguments
     )
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    type = hash[object_id].last # The last entry contains the type.
-    case left
-    # ======================================================================= #
-    # === :default
-    # ======================================================================= #
-    when :default
-      left = LibuiParadise.counter_left?
+    if padding_to_use.is_a? Hash
+      padding_to_use = 1 # Hardcoded exception.
     end
-    case top
-    # ======================================================================= #
-    # === :default
-    # ======================================================================= #
-    when :default
-      top = LibuiParadise.counter_top?
+    if padding_to_use > 1
+      padding_to_use = 1 # For now only a value of 1 seems to work.
+    end
+    current_widget = available_pointers?[self.object_id] # This will be an Array.
+    _pointer = current_widget.first # Not used currently in this method.
+    type     = current_widget.last
+    left_position = LibuiParadise.counter_left?
+    top_position  = LibuiParadise.counter_top?
+    if remaining_arguments[1]
+      top_position = remaining_arguments[1]
+    end
+    if remaining_arguments[0]
+      left_position = remaining_arguments[0]
+    else
+      LibuiParadise.increment_counter_left
     end
     case type
     # ======================================================================= #
-    # === :vbox
-    # ======================================================================= #
-    when :vbox
-      add(widget)
-    # ======================================================================= #
     # === :grid
+    #
+    # This entry-point is specifically for a ui-grid element.
+    #
+    # The positional arguments stand for:
+    #
+    #                     gtk-widget,  left, top, xspan, yspan, hexpand, halign, vexpand, valign
+    #   grid_append(grid, entry1,      0, 0, 2, 1, 0, 0, 1, 0)
+    #
     # ======================================================================= #
     when :grid
-      hash_grid(
-        widget,
-        {
-          left:    left,
-          top:     top,
-          xspan:   xspan,
-          yspan:   yspan,
-          hexpand: 0,
-          halign:  0,
-          vexpand: 0,
-          valign:  0
-        }
+      LibUI.grid_append(
+        self,
+        this_widget.to_s,
+        padding_to_use,
+        left_position,
+        top_position,
+        remaining_arguments[2],
+        remaining_arguments[3],
+        remaining_arguments[4],
+        remaining_arguments[5],
+        remaining_arguments[6]
+      )
+    # ======================================================================= #
+    # === :tab
+    #
+    # This is specifically for the notebook-tab. In this case the argument
+    # names do not make a lot of sense. For instance, this_widget is
+    # actually the text-title for the tab, and padding_to_use is the
+    # actual widget that will be embedded. Because this is, however had,
+    # the "minor use case", compared to the subsequent "else" clause, I
+    # will keep the name as-is. The comment here should be kept, in order
+    # to explain this peculiar oddity though.
+    # ======================================================================= #
+    when :tab
+      LibUI.tab_append(self, this_widget.to_s, padding_to_use)
+    # ======================================================================= #
+    # === :window
+    #
+    # Add support for the toplevel window here, as of September 2021.
+    # ======================================================================= #
+    when :window
+      LibUI.window_set_child(self, this_widget)
+    else # This is the default.
+      ::LibUI.box_append(
+        self, this_widget, padding_to_use
       )
-      LibuiParadise.counter_left += 1
-    else
     end
-  end
+  end; alias add        append # === add
+       alias <<         append # === <<
+       alias pack_start append # === pack_start
 
   # ========================================================================= #
-  # === new_row
-  # ========================================================================= #
-  def new_row
-    LibuiParadise.counter_left = 0
-    LibuiParadise.counter_top += 1
-  end
-
-  # ========================================================================= #
-  # === hash_grid
-  #
-  # Usage example:
-  #
-  #   hash_grid(text('Yo6'), { left: 0, top: 3, xspan: 1, yspan: 1, hexpand: 0, halign: 0, vexpand: 0, valign: 0 })
+  # === append_text_column
   #
+  # This method is specifically used for libui-tables.
   # ========================================================================= #
-  def hash_grid(
-      pass_this_widget,
-      hash = {}
+  def append_text_column(
+      text,
+      a,
+      b = -1
     )
-    array_to_be_passed = []
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    type = hash[object_id].last # The last entry contains the type.
+    case type
     # ======================================================================= #
-    # === :left
+    # === :table
+    #
+    # This is the primary entry point for this method.
     # ======================================================================= #
-    if hash.has_key? :left
-      array_to_be_passed << hash[:left]
+    when :table
+      ::LibUI.table_append_text_column(self, text, a, b)
     else
-      array_to_be_passed << 0
+      e 'Not registered type in .append_text_column(): '+type.to_s
     end
-    # ======================================================================= #
-    # === :top
-    # ======================================================================= #
-    if hash.has_key? :top
-      array_to_be_passed << hash[:top]
-    else
-      array_to_be_passed << 0
+  end
+
+  # ========================================================================= #
+  # === set_text
+  #
+  # This method can be used to set the text of a particular libui-widget,
+  # in particular entries.
+  # ========================================================================= #
+  def set_text(
+      display_this_text = '', # This is the text that will be used.
+      type              = nil
+    )
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    this_widget = hash[object_id].first
+    if type.nil?
+      type = hash[object_id].last # This should be :grid. But it is not used here.
     end
+    case type
     # ======================================================================= #
-    # === :xspan
+    # === :new_progress_bar
     # ======================================================================= #
-    if hash.has_key? :xspan
-      array_to_be_passed << hash[:xspan]
-    else
-      array_to_be_passed << 0
-    end
+    when :new_progress_bar
+      # This currently does nothing.
     # ======================================================================= #
-    # === :yspan
+    # === :multiline_entry
+    #
+    # This is a text-view widget actually.
     # ======================================================================= #
-    if hash.has_key? :yspan
-      array_to_be_passed << hash[:yspan]
-    else
-      array_to_be_passed << 0
-    end
+    when :multiline_entry
+      LibUI.multiline_entry_set_text(
+        this_widget,
+        display_this_text.to_s
+      )
     # ======================================================================= #
-    # === :hexpand
+    # === :text
     # ======================================================================= #
-    if hash.has_key? :hexpand
-      array_to_be_passed << hash[:hexpand]
-    else
-      array_to_be_passed << 0
-    end
+    when :text,
+         :label
+      LibUI.label_set_text(
+        this_widget,
+        display_this_text.to_s
+      )
     # ======================================================================= #
-    # === :halign
+    # === :textview
     # ======================================================================= #
-    if hash.has_key? :halign
-      array_to_be_passed << hash[:halign]
-    else
-      array_to_be_passed << 0
-    end
+    when :textview
+      LibUI.multiline_entry_set_text(
+        this_widget,
+        display_this_text.to_s
+      )
     # ======================================================================= #
-    # === :vexpand
+    # === :entry
     # ======================================================================= #
-    if hash.has_key? :vexpand
-      array_to_be_passed << hash[:vexpand]
-    else
-      array_to_be_passed << 0
-    end
+    when :entry
+      LibUI.entry_set_text(
+        this_widget,
+        display_this_text.to_s
+      )
     # ======================================================================= #
-    # === :valign
+    # === :search_entry
+    #
+    # This is specifically for a search-entry.
     # ======================================================================= #
-    if hash.has_key? :valign
-      array_to_be_passed << hash[:valign]
+    when :search_entry
+      LibUI.entry_set_text(
+        this_widget,
+        display_this_text.to_s
+      )
     else
-      array_to_be_passed << 0
+      puts 'Unhandled case in set_text(): '+
+           type.to_s
     end
-    ui_grid_append(pass_this_widget, *array_to_be_passed)
-  end; alias hash hash_grid # === hash
+  end; alias set_content set_text # === set_content
 
   # ========================================================================= #
-  # === ui_grid_append
-  #
-  # This method can be used to append onto a grid in LibUI.
-  #
-  # Usage example:
-  #
-  #   grid.grid_append(text('Right'), 1, 0, 1, 1, 0, 0.5, 1, 0)
-  #
+  # === group_maximal
   # ========================================================================= #
-  def ui_grid_append(
-      widget_to_append,
-      left    = 0,
-      top     = 0,
-      xspan   = 1,
-      yspan   = 1,     # 
-      hexpand = 0, # A "boolean". 0 means false here.
-      halign  = 0,
-      vexpand = 0, # A "boolean". 0 means false here.
-      valign  = 0
-    )
-    # ======================================================================= #
-    # The signature in Go is:
-    #
-    #   Append(child Control, left, top int, xspan, yspan int, hexpand bool, halign Align, vexpand bool, valign Align)
-    #
-    # ======================================================================= #
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    this_widget = hash[object_id].first
-    _type       = hash[object_id].last # This should be :grid. But it is not used here.
-    # ======================================================================= #
-    # left, top, xspan, yspan, hexpand, halign, vexpand, valign
-    #  0,    0,    2,     1,      0,      0,       1,      0
-    # ======================================================================= #
-    LibUI.grid_append(
+  def group_maximal(*i)
+    i.flatten.each {|entry|
+      maximal(entry)
+    }
+  end
+
+  # ========================================================================= #
+  # === maximal
+  # ========================================================================= #
+  def maximal(this_widget, optional_padding = 1)
+    add(this_widget, optional_padding)
+  end
+
+  # ========================================================================= #
+  # === minimal
+  # ========================================================================= #
+  def minimal(
       this_widget,
-      widget_to_append,
-      left,
-      top,
-      xspan,
-      yspan,
-      hexpand,
-      halign,
-      vexpand,
-      valign
+      optional_padding = 0
     )
-  end; alias grid_append ui_grid_append # === grid_append
+    add(this_widget, optional_padding)
+  end
 
   # ========================================================================= #
-  # === append                                          (append tag, add tag)
+  # === set_value
+  #
+  # This method has initially been created to assign a value to a
+  # spinbutton. That way the following API is made possible:
+  #
+  #   spinbutton.set_value(42)
   #
-  # This is simply a wrapper over LibUI.box_append().
   # ========================================================================= #
-  def append(
-      this_widget,
-      padding_to_use = 1,
-      *remaining_arguments
+  def set_value(
+      new_value
     )
-    current_widget = available_pointers?[self.object_id] # This will be an Array.
-    _pointer = current_widget.first # Not used currently in this method.
-    type     = current_widget.last
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    this_widget = hash[object_id].first
+    type = hash[object_id].last
     case type
     # ======================================================================= #
-    # === :grid
+    # === :new_progress_bar
     #
-    # This entry-point is specifically for a ui-grid element.
+    # This is actually a progress-bar.
     # ======================================================================= #
-    when :grid
-      LibUI.grid_append(
-        self,
-        this_widget.to_s,
-        padding_to_use,
-        remaining_arguments[0],
-        remaining_arguments[1],
-        remaining_arguments[2],
-        remaining_arguments[3],
-        remaining_arguments[4],
-        remaining_arguments[5],
-        remaining_arguments[6]
-      )
+    when :new_progress_bar,
+         :progress_bar
+      ::LibUI.progress_bar_set_value(this_widget, new_value.to_i)
     # ======================================================================= #
-    # === :tab
-    #
-    # This is specifically for the notebook-tab. In this case the argument
-    # names do not make a lot of sense. For instance, this_widget is
-    # actually the text-title for the tab, and padding_to_use is the
-    # actual widget that will be embedded. Because this is, however had,
-    # the "minor use case", compared to the subsequent "else" clause, I
-    # will keep the name as-is. The comment here should be kept, in order
-    # to explain this peculiar oddity though.
+    # === :spinbox
     # ======================================================================= #
-    when :tab
-      LibUI.tab_append(self, this_widget.to_s, padding_to_use)
+    when :spinbox
+      ::LibUI.spinbox_set_value(
+        this_widget,
+        new_value.to_i # Must be an Integer.
+      )
+    else
+      e 'Not registered type: '+type.to_s
+    end
+  end; alias value=          set_value # === value=
+       alias start_position= set_value # === start_position=
+
+  # ========================================================================= #
+  # === append_this_array
+  #
+  # This method only works for comboboxes.
+  # ========================================================================= #
+  def append_this_array(array)
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    _this_widget = hash[object_id].first # This variable is currently not in use.
+    type        = hash[object_id].last
+    case type
     # ======================================================================= #
-    # === :window
-    #
-    # Add support for the toplevel window here, as of September 2021.
+    # === :combobox
     # ======================================================================= #
-    when :window
-      LibUI.window_set_child(self, this_widget)
-    else # This is the default.
-      LibUI.box_append(
-        self, this_widget, padding_to_use
-      )
+    when :combobox
+      array.each {|this_entry|
+        LibUI.combobox_append(self, this_entry)
+      }
+      LibUI.combobox_set_selected(self, 0) # The first one will be active too.    
     end
-  end; alias add append # === add
-       alias <<  append # === <<
+  end
 
   # ========================================================================= #
-  # === clear
+  # === empty?
   # ========================================================================= #
-  def clear(
-      current_widget = available_pointers?[self.object_id] # This will be an Array.
+  def empty?(
+      type = nil
     )
-    _pointer = current_widget.first # Not used currently in this method.
-    type     = current_widget.last
-
     object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
+    hash = hash_fiddle_pointer_widgets?
     if type.nil?
-      type = hash[object_id].last # This should be :grid. But it is not used here.
+      # ===================================================================== #
+      # In this case we must determine the type in use.
+      # ===================================================================== #
+      if hash.has_key? object_id
+        type = hash[object_id].last # The last entry contains the type.
+      end
     end
     case type
     # ======================================================================= #
-    # === :combobox
-    #
-    # This currently does not work; it depends on libui-ng, which has not
-    # yet been added completely.
+    # === :entry
     # ======================================================================= #
-    when :combobox
-    #   LibUI.multiline_entry_set_text(
-    #     this_widget,
-    #     display_this_text.to_s
-    #   )
+    when :entry
+      self.text?.empty?
     else
-      puts "Unhandled case in clear(): "\
-           "#{type}"
+      return true
     end
   end
 
@@ -616,11 +674,11 @@ class Pointer # === Fiddle::Pointer
   # Set a uniform padding via this method.
   # ========================================================================= #
   def padded=(
-      pad_n_px = 25,
+      pad_n_px = 25, # How much to pad in n px. LibUI currently does not allow for that, though.
       type     = nil
     )
     object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
+    hash = hash_fiddle_pointer_widgets?
     if type.nil?
       # ===================================================================== #
       # In this case we must determine the type in use.
@@ -631,6 +689,11 @@ class Pointer # === Fiddle::Pointer
     end
     case type
     # ======================================================================= #
+    # === :window
+    # ======================================================================= #
+    when :window
+      LibUI.window_set_margined(self, 1)
+    # ======================================================================= #
     # === :grid
     # ======================================================================= #
     when :grid
@@ -661,163 +724,8 @@ class Pointer # === Fiddle::Pointer
       pp caller()
       puts "#{type} (class #{type.class}) is not yet implemented in .padded=."
     end
-  end; alias set_padded padded= # === set_padded
-
-  # ========================================================================= #
-  # === disable                                                  (disable tag)
-  # ========================================================================= #
-  def disable(&block)
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    type = hash[object_id].last # The last entry contains the type.
-    case type
-    # ======================================================================= #
-    # === :button
-    # ======================================================================= #
-    when :button
-      LibUI.control_disable(self)
-    else
-      e 'Not registered type in .disable(): '+type.to_s
-    end
-  end
-
-  # ========================================================================= #
-  # === populate
-  # ========================================================================= #
-  def populate(dataset)
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    type = hash[object_id].last
-    case type
-    # ======================================================================= #
-    # === :combobox
-    # ======================================================================= #
-    when :combobox
-      self.append_this_array(dataset)
-    end
-  end
-
-  # ========================================================================= #
-  # === is_padded
-  # ========================================================================= #
-  def is_padded
-    set_padded(1)
-  end
-
-  # ========================================================================= #
-  # === on_clicked
-  #
-  # This method is in general called on a button-widget.
-  # ========================================================================= #
-  def on_clicked(&block)
-    LibUI.button_on_clicked(self, &block)
-  end; alias on_click_event on_clicked # === on_click_event
-
-  # ========================================================================= #
-  # === available_pointers?
-  # ========================================================================= #
-  def available_pointers?
-    LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-  end; alias main_hash? available_pointers? # === main_hash?
-
-  # ========================================================================= #
-  # === empty?
-  # ========================================================================= #
-  def empty?(
-      type = nil
-    )
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    if type.nil?
-      # ===================================================================== #
-      # In this case we must determine the type in use.
-      # ===================================================================== #
-      if hash.has_key? object_id
-        type = hash[object_id].last # The last entry contains the type.
-      end
-    end
-    case type
-    # ======================================================================= #
-    # === :entry
-    # ======================================================================= #
-    when :entry
-      self.text?.empty?
-    else
-      return true
-    end
-  end
-
-  # ========================================================================= #
-  # === is_read_only
-  # ========================================================================= #
-  def is_read_only(
-      current_widget = available_pointers?[self.object_id] # This will be an Array.
-    )
-    _pointer = current_widget.first # Not used currently in this method.
-    type     = current_widget.last
-    case type
-    # ======================================================================= #
-    # === :multiline_entry
-    # ======================================================================= #
-    when :multiline_entry
-      LibUI.multiline_entry_set_read_only(self, 1)
-    else
-      pp caller()
-      puts "#{type} (class #{type.class}) is not yet implemented in .padded=."
-    end
-  end
-
-  # ========================================================================= #
-  # === append_this_string
-  #
-  # This method can be used to append a String to an existing String.
-  # ========================================================================= #
-  def append_this_string(i)
-    ::LibUI.attributed_string_append_unattributed(self, i)
-  end
-
-  # ========================================================================= #
-  # === append_this_array
-  # ========================================================================= #
-  def append_this_array(array)
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    _this_widget = hash[object_id].first # This variable is currently not in use.
-    type        = hash[object_id].last
-    case type
-    # ======================================================================= #
-    # === :combobox
-    # ======================================================================= #
-    when :combobox
-      array.each {|this_entry|
-        LibUI.combobox_append(self, this_entry)
-      }
-      LibUI.combobox_set_selected(self, 0) # The first one will be active too.    
-    end
-  end
-
-  # ========================================================================= #
-  # === maximal
-  # ========================================================================= #
-  def maximal(this_widget, optional_padding = 1)
-    add(this_widget, optional_padding)
-  end
-
-  # ========================================================================= #
-  # === group_maximal
-  # ========================================================================= #
-  def group_maximal(*i)
-    i.flatten.each {|entry|
-      maximal(entry)
-    }
-  end
-
-  # ========================================================================= #
-  # === minimal
-  # ========================================================================= #
-  def minimal(this_widget, optional_padding = 0)
-    add(this_widget, optional_padding)
-  end
+  end; alias set_padded  padded= # === set_padded
+       alias set_padding padded= # === set_padding
 
   # ========================================================================= #
   # === text
@@ -838,7 +746,7 @@ class Pointer # === Fiddle::Pointer
     )
     i = i.to_s # Let's ensure we have a String past this point.
     object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
+    hash = hash_fiddle_pointer_widgets?
     _this_widget = hash[object_id].first # This variable is currently not in use.
     type        = hash[object_id].last
     case type
@@ -852,18 +760,6 @@ class Pointer # === Fiddle::Pointer
     end
   end; alias add_text text # === text
 
-  # ========================================================================= #
-  # === add_hsep
-  #
-  # This method adds a horizontal separator.
-  # ========================================================================= #
-  def add_hsep
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    this_widget = hash[object_id].first
-    this_widget.add(::LibuiParadise::Extensions.horizontal_separator, 0)
-  end; alias add_horizontal_separator add_hsep # === add_horizontal_separator
-
   # ========================================================================= #
   # === active?
   # ========================================================================= #
@@ -876,7 +772,7 @@ class Pointer # === Fiddle::Pointer
     # === :checkbox
     # ======================================================================= #
     when :checkbox
-      checked = (UI.checkbox_checked(pointer) == 1)
+      checked = (::LibUI.checkbox_checked(pointer) == 1)
       return (checked == true)
     # ======================================================================= #
     # === :entry
@@ -890,38 +786,111 @@ class Pointer # === Fiddle::Pointer
   end; alias is_active? active? # === is_active?
 
   # ========================================================================= #
-  # === set_active
+  # === set_active
+  # ========================================================================= #
+  def set_active
+    current_widget = available_pointers?[self.object_id] # This will be an Array.
+    pointer = current_widget.first
+    type    = current_widget.last
+    case type
+    # ======================================================================= #
+    # === :checkbox
+    # ======================================================================= #
+    when :checkbox
+      ::LibUI.checkbox_set_checked(pointer, 1)
+    end
+  end; alias is_active     set_active # === is_active
+       alias is_now_active set_active # === is_now_active
+
+  # ========================================================================= #
+  # === set_inactive
+  #
+  # This method currently only works for libui-checkboxes.
+  # ========================================================================= #
+  def set_inactive
+    current_widget = available_pointers?[self.object_id] # This will be an Array.
+    pointer = current_widget.first
+    type    = current_widget.last
+    case type
+    # ======================================================================= #
+    # === :checkbox
+    # ======================================================================= #
+    when :checkbox
+      ::LibUI.checkbox_set_checked(pointer, 0)
+    end
+  end; alias is_inactive     set_inactive # === is_inactive
+       alias is_now_inactive set_inactive # === is_now_inactive
+
+  # ========================================================================= #
+  # === disable                                                  (disable tag)
+  # ========================================================================= #
+  def disable(&block)
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    type = hash[object_id].last # The last entry contains the type.
+    case type
+    # ======================================================================= #
+    # === :button
+    # ======================================================================= #
+    when :button
+      LibUI.control_disable(self)
+    else
+      e 'Not registered type in .disable(): '+type.to_s
+    end
+  end
+
+  # ========================================================================= #
+  # === enable                                                   (enable tag)
   # ========================================================================= #
-  def set_active
-    current_widget = available_pointers?[self.object_id] # This will be an Array.
-    pointer = current_widget.first
-    type    = current_widget.last
+  def enable(&block)
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    type = hash[object_id].last # The last entry contains the type.
     case type
     # ======================================================================= #
-    # === :checkbox
+    # === :button
     # ======================================================================= #
-    when :checkbox
-      LibUI.checkbox_set_checked(pointer, 1)
+    when :button
+      LibUI.control_enable(self)
+    else
+      e 'Not registered type in .enable(): '+type.to_s
     end
-  end; alias is_active     set_active # === is_active
-       alias is_now_active set_active # === is_now_active
+  end
 
   # ========================================================================= #
-  # === set_inactive
+  # === is_padded
   # ========================================================================= #
-  def set_inactive
-    current_widget = available_pointers?[self.object_id] # This will be an Array.
-    pointer = current_widget.first
-    type    = current_widget.last
+  def is_padded
+    set_padded(1)
+  end
+
+  # ========================================================================= #
+  # === on_clicked
+  #
+  # This method is in general called on a button-widget. It allows us
+  # to simulate the action associated with clicking on a button.
+  # ========================================================================= #
+  def on_clicked(&block)
+    ::LibUI.button_on_clicked(self, &block)
+  end; alias on_click_event on_clicked # === on_click_event
+
+  # ========================================================================= #
+  # === populate
+  #
+  # This method will (try to) populate a combobox in LibUI.
+  # ========================================================================= #
+  def populate(dataset)
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    type = hash[object_id].last
     case type
     # ======================================================================= #
-    # === :checkbox
+    # === :combobox
     # ======================================================================= #
-    when :checkbox
-      LibUI.checkbox_set_checked(pointer, 0)
+    when :combobox
+      self.append_this_array(dataset)
     end
-  end; alias is_inactive     set_inactive # === is_inactive
-       alias is_now_inactive set_inactive # === is_now_inactive
+  end
 
   # ========================================================================= #
   # === child
@@ -937,7 +906,7 @@ class Pointer # === Fiddle::Pointer
   # === show_the_controls
   # ========================================================================= #
   def show_the_controls
-    LibUI.control_show(self)
+    ::LibUI.control_show(self)
   end; alias control_show show_the_controls # === control_show
 
   # ========================================================================= #
@@ -946,7 +915,7 @@ class Pointer # === Fiddle::Pointer
   # For now this only works on @main_window.
   # ========================================================================= #
   def is_margined(
-      i = LibuiParadise::Extensions.main_window?
+      i = LibuiParadise.main_window?
     )
     id = self.object_id
     hash = main_hash?
@@ -958,7 +927,7 @@ class Pointer # === Fiddle::Pointer
       # === :window
       # ===================================================================== #
       when :window
-        LibUI.window_set_margined(_.first, 1)
+        ::LibUI.window_set_margined(_.first, 1)
       else
         e 'The type '+type.to_s+' in is_margined() is currently not supported.'
       end
@@ -975,6 +944,40 @@ class Pointer # === Fiddle::Pointer
   end; alias uses_a_margin is_margined # === uses_a_margin
        alias has_margin    is_margined # === has_margin
 
+  # ========================================================================= #
+  # === autotitle
+  # ========================================================================= #
+  def autotitle(
+      i = title?
+    )
+    if i and respond_to?(:set_title)
+      set_title(i)
+    end
+  end
+
+  # ========================================================================= #
+  # === add_hsep
+  #
+  # This method adds a horizontal separator.
+  # ========================================================================= #
+  def add_hsep
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    this_widget = hash[object_id].first
+    this_widget.add(::LibuiParadise.horizontal_separator, 0)
+  end; alias add_horizontal_separator add_hsep # === add_horizontal_separator
+
+  # ========================================================================= #
+  # === main_then_quit
+  #
+  # We use ::LibUI just in case to avoid any possible name-collisions.
+  # ========================================================================= #
+  def main_then_quit
+    ::LibUI.main
+    ::LibUI.quit
+    #::LibUI.uninit # Trying this since as of November 2023. Nope, does not work.
+  end
+
   # ========================================================================= #
   # === close_properly
   #
@@ -993,54 +996,157 @@ class Pointer # === Fiddle::Pointer
        alias should_quit close_properly # === should_quit
 
   # ========================================================================= #
-  # === main_then_quit
+  # === fraction=
   #
-  # We use ::LibUI just in case to avoid any possible name-collisions.
+  # This method is mostly a wrapper to reach ruby-gtk3 compatibility.
   # ========================================================================= #
-  def main_then_quit
-    ::LibUI.main
-    ::LibUI.quit
-    #::LibUI.uninit # Trying this since as of November 2023. Nope, does not work.
+  def fraction=(i = '')
+    i = i * 100
+    set_value(i)
   end
 
   # ========================================================================= #
-  # === show_then_main_then_quit
-  #
-  # This method ultimately combines three other method calls.
+  # === left                                                       (left tag)
   # ========================================================================= #
-  def show_then_main_then_quit
-    ::LibUI.control_show(self)
-    main_then_quit
-  end; alias elegant_exit           show_then_main_then_quit # === elegant_exit
-       alias complex_finalizer      show_then_main_then_quit # === complex_finalizer
-       alias intelligent_close_down show_then_main_then_quit # === intelligent_close_down
-       alias intelligent_quit       show_then_main_then_quit # === intelligent_quit
-       alias intelligent_exit       show_then_main_then_quit # === intelligent_exit
+  def left(
+      widget,
+      left  = LibuiParadise.counter_left?,
+      top   = LibuiParadise.counter_top?,
+      xspan = 1,
+      yspan = 1
+    )
+    object_id = self.object_id
+    hash = hash_fiddle_pointer_widgets?
+    type = hash[object_id].last # The last entry contains the type.
+    case left
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default
+      left = LibuiParadise.counter_left?
+    end
+    case top
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default
+      top = LibuiParadise.counter_top?
+    end
+    case type
+    # ======================================================================= #
+    # === :vbox
+    # ======================================================================= #
+    when :vbox
+      add(widget)
+    # ======================================================================= #
+    # === :grid
+    # ======================================================================= #
+    when :grid
+      hash_grid(
+        widget,
+        {
+          left:    left,
+          top:     top,
+          xspan:   xspan,
+          yspan:   yspan,
+          hexpand: 0,
+          halign:  0,
+          vexpand: 0,
+          valign:  0
+        }
+      )
+      LibuiParadise.counter_left += 1
+    else
+    end
+  end; alias middle left # === middle
 
   # ========================================================================= #
-  # === append_text_column
+  # === hash_grid
+  #
+  # Usage example:
+  #
+  #   hash_grid(text('Yo6'), { left: 0, top: 3, xspan: 1, yspan: 1, hexpand: 0, halign: 0, vexpand: 0, valign: 0 })
   #
-  # This method is specifically used for libui-tables.
   # ========================================================================= #
-  def append_text_column(
-      text,
-      a,
-      b = -1
+  def hash_grid(
+      pass_this_widget,
+      hash = {}
     )
-    object_id = self.object_id
-    hash = LibuiParadise::Extensions.hash_fiddle_pointer_widgets?
-    type = hash[object_id].last # The last entry contains the type.
-    case type
+    array_to_be_passed = []
     # ======================================================================= #
-    # === :table
-    #
-    # This is the primary entry point for this method.
+    # === :left
     # ======================================================================= #
-    when :table
-      ::LibUI.table_append_text_column(self, text, a, b)
+    if hash.has_key? :left
+      array_to_be_passed << hash[:left]
     else
-      e 'Not registered type in .append_text_column(): '+type.to_s
+      array_to_be_passed << 0
+    end
+    # ======================================================================= #
+    # === :top
+    # ======================================================================= #
+    if hash.has_key? :top
+      array_to_be_passed << hash[:top]
+    else
+      array_to_be_passed << 0
+    end
+    # ======================================================================= #
+    # === :xspan
+    # ======================================================================= #
+    if hash.has_key? :xspan
+      array_to_be_passed << hash[:xspan]
+    else
+      array_to_be_passed << 0
+    end
+    # ======================================================================= #
+    # === :yspan
+    # ======================================================================= #
+    if hash.has_key? :yspan
+      array_to_be_passed << hash[:yspan]
+    else
+      array_to_be_passed << 0
+    end
+    # ======================================================================= #
+    # === :hexpand
+    # ======================================================================= #
+    if hash.has_key? :hexpand
+      array_to_be_passed << hash[:hexpand]
+    else
+      array_to_be_passed << 0
+    end
+    # ======================================================================= #
+    # === :halign
+    # ======================================================================= #
+    if hash.has_key? :halign
+      array_to_be_passed << hash[:halign]
+    else
+      array_to_be_passed << 0
+    end
+    # ======================================================================= #
+    # === :vexpand
+    # ======================================================================= #
+    if hash.has_key? :vexpand
+      array_to_be_passed << hash[:vexpand]
+    else
+      array_to_be_passed << 0
+    end
+    # ======================================================================= #
+    # === :valign
+    # ======================================================================= #
+    if hash.has_key? :valign
+      array_to_be_passed << hash[:valign]
+    else
+      array_to_be_passed << 0
     end
+    ui_grid_append(pass_this_widget, *array_to_be_passed)
+  end; alias hash hash_grid # === hash
+
+  # ========================================================================= #
+  # === append_this_string
+  #
+  # This method can be used to append a String to an existing String.
+  # ========================================================================= #
+  def append_this_string(i)
+    ::LibUI.attributed_string_append_unattributed(self, i)
   end
 
   # ========================================================================= #
@@ -1098,6 +1204,7 @@ class Pointer # === Fiddle::Pointer
   def set_row_spacing(i = 1); end
   def css_class(i = ''); end
   def set_border_width(i = 2); end
+      alias set_border_size set_border_width
   def set_colour(i = 'blue'); end
   def make_bold; end
   def set_name(i = ''); end
@@ -1112,6 +1219,7 @@ class Pointer # === Fiddle::Pointer
   def lightgreen; end
   def set_background_colour(i = ''); end
   def set_size_request(a = 42, b = 42); end
+  def set_size(a = 42, b = 42); end
   def the_first_entry_is_active; end
   def clear_old_datapoints; end
   def width_height(a = 500, b = 500); end
@@ -1123,6 +1231,7 @@ class Pointer # === Fiddle::Pointer
   def enable_free_form_css; end
   def show_all; end # This one here may become a real method one day, but right now I don't know how to enable that.
   def align_to_the_left; end
+  def align_to_the_right; end
   def yellowish_background; end
   def on_enter; end
   def on_value_changed; end
@@ -1143,7 +1252,9 @@ class Pointer # === Fiddle::Pointer
   def font=(i = ''); end
   def set_activates_default(i = true); end
   def enable_events; end
+  def enable_all_events; end
   def do_focus; end
+  def set_homogeneous(i = true); end
   def border(i = '', *a); end
   def fancy_hint(i = ''); end
   def fancy_hints(i = ''); end
@@ -1160,6 +1271,8 @@ class Pointer # === Fiddle::Pointer
   end
   def set_font_size(i = :hack_26) # Currently not in use.
   end
+  def maximize # This should maximize the window. It does not yet work.
+  end
   def use_gtk_paradise_project_css_file; end
   def on_hover_colour(i = '', &block); end
   def deselect; end
@@ -1172,5 +1285,27 @@ class Pointer # === Fiddle::Pointer
   end
   def default_styling(i = '')
   end
+  # ========================================================================= #
+  # === This is currently not in use.
+  # ========================================================================= #
+  def padding=(i = 8)
+  end
+
+  # ========================================================================= #
+  # === uniform_spacing
+  # ========================================================================= #
+  def uniform_spacing(i = 8)
+  end
 
+  def disable_user_input; end
+  def disallow_resizing
+  end
+  def on_enter_key_pressed(&block)
+  end
+  def use_this_font(i = '')
+  end
+  def set_default_size(a = 680, b = 560)
+  end
+  def top_left
+  end
 end; end