gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/gtk_classes/tree_view.rb

@@ -8,7 +8,7 @@
 # =========================================================================== #
 module Gtk
 
-class TreeView
+class TreeView # === Gtk::TreeView
 
   # ========================================================================= #
   # === rubber_banding
@@ -17,6 +17,34 @@ class TreeView
     set_rubber_banding(true)
   end
 
+  # ========================================================================= #
+  # === do_use_clickable_headers
+  # ========================================================================= #
+  def do_use_clickable_headers
+    self.headers_clickable = true
+  end; alias use_clickable_headers     do_use_clickable_headers # === use_clickable_headers
+       alias clickable_headers         do_use_clickable_headers # === clickable_headers
+       alias the_headers_are_clickable do_use_clickable_headers # === the_headers_are_clickable
+
+  # ========================================================================= #
+  # == deselect_on_right_click_event
+  # ========================================================================= #
+  def deselect_on_right_click_event
+    on_button_press_event { |widget, event|
+      case event.button
+      when 3 # Right-mouse button was clicked here.
+        self.deselect
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === deselect
+  # ========================================================================= #
+  def deselect
+    selection.unselect_all
+  end; alias deselect_everything deselect # === deselect_everything
+
   # ========================================================================= #
   # === all_are_sortable
   #
@@ -27,6 +55,11 @@ class TreeView
   #
   # It will be applied onto ALL columns, so only call the method if you
   # really want that.
+  #
+  # Note that this is NOT the same as calling .sortable_based_on() -
+  # the latter implements the actual arrow-down interface that the
+  # user can then use, by clicking on it. The method here does NOT
+  # do so.
   # ========================================================================= #
   def all_are_sortable(
       columns = columns?
@@ -34,17 +67,11 @@ class TreeView
     columns.each_with_index {|content, index|
       content.set_sort_column_id(index)
     }
-  end; alias make_sortable  all_are_sortable # === make_sortable
-       alias make_resizable all_are_sortable # === make_resizable
-       alias is_sortable    all_are_sortable # === is_sortable
-       alias linear_sorting all_are_sortable # === linear_sorting
-
-  # ========================================================================= #
-  # === deselect
-  # ========================================================================= #
-  def deselect
-    selection.unselect_all
-  end; alias deselect_everything deselect # === deselect_everything
+  end; alias make_sortable         all_are_sortable # === make_sortable
+       alias make_resizable        all_are_sortable # === make_resizable
+       alias is_sortable           all_are_sortable # === is_sortable
+       alias linear_sorting        all_are_sortable # === linear_sorting
+       alias the_rows_are_sortable all_are_sortable # === the_rows_are_sortable
 
   # ========================================================================= #
   # === allow_resizing
@@ -59,15 +86,64 @@ class TreeView
     modify_these_columns.each {|this_column|
       this_column.set_resizable(true)
     }
-  end; alias headers_can_be_moved       allow_resizing # === headers_can_be_moved
-       alias the_headers_can_be_moved   allow_resizing # === the_headers_can_be_moved
+  end; alias can_be_resized             allow_resizing # === can_be_resized
+       alias resizable_headers          allow_resizing # === resizable_headers
+       alias headers_can_be_moved       allow_resizing # === headers_can_be_moved
        alias the_headers_can_be_dragged allow_resizing # === the_headers_can_be_dragged
+       alias the_headers_can_be_moved   allow_resizing # === the_headers_can_be_moved
        alias the_header_can_be_dragged  allow_resizing # === the_header_can_be_dragged
-       alias the_headers_are_resizable  allow_resizing # === the_headers_are_resizable
-       alias can_be_resized             allow_resizing # === can_be_resized
-       alias resizable_headers          allow_resizing # === resizable_headers
        alias the_header_can_be_resized  allow_resizing # === the_header_can_be_resized
+       alias the_headers_are_resizable  allow_resizing # === the_headers_are_resizable
        alias the_headers_can_be_resized allow_resizing # === the_headers_can_be_resized
+       alias the_header_are_clickable   allow_resizing # === the_headers_are_clickable
+
+  # ========================================================================= #
+  # === clear
+  #
+  # Remove the associated list-store. This currently does not work
+  # very well.
+  # ========================================================================= #
+  def clear
+    self.model = nil # Or list_store.clear
+  end
+
+  # ========================================================================= #
+  # === enable_drag_and_drop
+  #
+  # Simplified method to enable drag-and-drop.
+  # ========================================================================= #
+  def enable_drag_and_drop
+    if ::Gtk.use_gtk2?
+      enable_model_drag_source(Gdk::Window::BUTTON1_MASK, 
+        [
+          ['GTK_TREE_MODEL_ROW', 0, 0]
+        ],
+        Gdk::DragContext::ACTION_COPY|Gdk::DragContext::ACTION_MOVE
+      )
+      enable_model_drag_dest(
+        [
+          ['GTK_TREE_MODEL_ROW', 0, 0]
+        ],
+        Gdk::DragContext::ACTION_COPY|Gdk::DragContext::ACTION_MOVE
+      )
+    else # else use gtk3
+      # ===================================================================== #
+      # === GTK3
+      # ===================================================================== #
+      target_table = [['GTK_TREE_MODEL_ROW', 0, 0]]
+      enable_model_drag_source(:button1_mask, 
+        target_table,
+        Gdk::DragAction::COPY|Gdk::DragAction::MOVE
+      )
+      enable_model_drag_dest(
+        target_table,
+        Gdk::DragAction::COPY|Gdk::DragAction::MOVE
+      )
+    end
+  end; alias enable_dragging                  enable_drag_and_drop # === enable_dragging
+       alias make_reorderable                 enable_drag_and_drop # === make_reorderable
+       alias the_columns_can_be_rearranged    enable_drag_and_drop # === the_columns_can_be_rearranged
+       alias drag_action_copy_and_action_move enable_drag_and_drop # === drag_action_copy_and_action_move
 
   # ========================================================================= #
   # === enable_search
@@ -85,16 +161,6 @@ class TreeView
     }
   end; alias remove_all_columns remove_the_columns # === remove_all_columns
 
-  # ========================================================================= #
-  # === clear
-  #
-  # Remove the associated list-store. This currently does not work
-  # very well.
-  # ========================================================================= #
-  def clear
-    self.model = nil # Or list_store.clear
-  end
-
   # ========================================================================= #
   # === use_these_headers
   #
@@ -179,40 +245,6 @@ class TreeView
     }
   end
 
-  # ========================================================================= #
-  # === enable_drag_and_drop
-  #
-  # Simplified method to enable drag-and-drop.
-  # ========================================================================= #
-  def enable_drag_and_drop
-    if ::Gtk.use_gtk2?
-      enable_model_drag_source(Gdk::Window::BUTTON1_MASK, 
-        [
-          ['GTK_TREE_MODEL_ROW', 0, 0]
-        ],
-        Gdk::DragContext::ACTION_COPY|Gdk::DragContext::ACTION_MOVE
-      )
-      enable_model_drag_dest(
-        [
-          ['GTK_TREE_MODEL_ROW', 0, 0]
-        ], 
-        Gdk::DragContext::ACTION_COPY|Gdk::DragContext::ACTION_MOVE
-      )
-    else # else use gtk3
-      target_table = [['GTK_TREE_MODEL_ROW', 0, 0]]
-      enable_model_drag_source(:button1_mask, 
-        target_table,
-        Gdk::DragAction::COPY|Gdk::DragAction::MOVE
-      )
-      enable_model_drag_dest(
-        target_table,
-        Gdk::DragAction::COPY|Gdk::DragAction::MOVE
-      )
-    end
-  end; alias make_reorderable                 enable_drag_and_drop # === make_reorderable
-       alias drag_action_copy_and_action_move enable_drag_and_drop # === drag_action_copy_and_action_move
-       alias enable_dragging                  enable_drag_and_drop # === enable_dragging
-
   # ========================================================================= #
   # === return_the_selection
   #
@@ -287,15 +319,6 @@ class TreeView
     selection.mode = selection_single
   end; alias enable_single_selection enable_selection_single # === enable_single_selection
 
-  # ========================================================================= #
-  # === do_use_clickable_headers
-  # ========================================================================= #
-  def do_use_clickable_headers
-    self.headers_clickable = true
-  end; alias use_clickable_headers     do_use_clickable_headers # === use_clickable_headers
-       alias clickable_headers         do_use_clickable_headers # === clickable_headers
-       alias the_headers_are_clickable do_use_clickable_headers # === the_headers_are_clickable
-
   # ========================================================================= #
   # === enable_selection_multiple
   #

data/lib/gtk_paradise/gtk_classes/tree_view_column.rb

@@ -8,7 +8,7 @@
 # =========================================================================== #
 module Gtk
 
-class TreeViewColumn
+class TreeViewColumn # === Gtk::TextViewColumn
 
   # ========================================================================= #
   # === cell_renderers?
@@ -58,5 +58,6 @@ class TreeViewColumn
     set_alignment(0.5)
   end; alias align_to_the_middle center # === align_to_the_middle
        alias into_the_middle     center # === into_the_middle
+       alias align_to_the_center center # === align_to_the_center
 
 end; end

data/lib/gtk_paradise/gtk_classes/vbox.rb

@@ -2,6 +2,8 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
+# === Gtk::VBox
+#
 # This variant only has to work for ruby-gtk2. In ruby-gtk3 we do not need
 # it.
 # =========================================================================== #
@@ -9,14 +11,11 @@
 # =========================================================================== #
 require 'gtk_paradise/toplevel_methods/determine_which_gtk_version_is_in_use.rb'
 
-if ::Gtk.use_gtk2?
+return unless Gtk.do_we_use_gtk2?
 
 module Gtk
 
-# =========================================================================== #
-# === Gtk::VBox
-# =========================================================================== #
-class VBox
+class VBox # === Gtk::VBox
 
   alias pack pack_start # === pack
 
@@ -34,18 +33,80 @@ class VBox
 
 end
 
+# =========================================================================== #
+# === Gtk.create_paned_vbox
+#
+# This will use a default padding of 2.
+#
+# create_paned_vbox(widget1,widget2)
+# =========================================================================== #
+def self.create_paned_vbox(*widgets)
+  default_padding = block_given? ? yield : 2
+  vbox = ::Gtk::VBox.new
+  widgets.flatten!
+  widgets.size.times { |t|
+    work_with_this_widget = widgets[t]
+    if work_with_this_widget.is_a? String
+      work_with_this_widget = ::Gtk.text(work_with_this_widget)
+    end
+    vbox.pack_start(work_with_this_widget, true, true, default_padding)
+  }
+  return vbox.show
+end; self.instance_eval { alias vbox       create_paned_vbox } # === Gtk.vbox
+     self.instance_eval { alias add_vbox   create_paned_vbox } # === Gtk.add_vbox
+     self.instance_eval { alias paned_vbox create_paned_vbox } # === Gtk.paned_vbox
+
+# =========================================================================== #
+# === Gtk.padded_vbox
+# =========================================================================== #
+def self.padded_vbox(
+    n_padding_to_use = 8
+  )
+  _ = vbox
+  _.set_border_width(n_padding_to_use)
+  return _
+end
+
+# =========================================================================== #
+# === Gtk.create_paned_vbox_last_big
+#
+# For this method, the first widget passed in (aka the first argument)
+# will take up most space here. This may fit if you want to use a 
+# large image on the left-hand side, and then some label on the right
+# hand side describing when this picture was taken, or a similar
+# use case.
+#
+# Usage example:
+#
+#   create_paned_vbox_last_big(Gtk::Button.new, Gtk::Button.new, Gtk::Button.new)
+#
+# =========================================================================== #
+def self.create_paned_vbox_last_big(*widgets)
+  widgets.flatten!
+  how_many_slots = widgets.size
+  vbox = ::Gtk::VBox.new
+  how_many_slots.times { |entry|
+    case entry
+    when 0
+      vbox.pack_start(widgets[entry], false, true, 1)
+    else
+      vbox.maximal(widgets[entry], 1)
+    end
+  }
+  return vbox.show
+end
+
 # =========================================================================== #
 # === Gtk.create_vbox
 # =========================================================================== #
 def self.create_vbox
   ::Gtk::VBox.new
-end; self.instance_eval { alias vbox create_vbox } # === Gtk.vbox
+end; self.instance_eval { alias vbox        create_vbox } # === Gtk.vbox
+     self.instance_eval { alias return_vbox create_vbox } # === Gtk.return_vbox
 
 # =========================================================================== #
-# === Add an alias to VBox
+# === Add an alias to VBox if we use ruby-gtk2
 # =========================================================================== #
 Vbox = VBox
 
-end
-
-end # End gtk2-check.
+end

data/lib/gtk_paradise/gtk_classes/vscale.rb

@@ -13,9 +13,9 @@ module Gtk
   # === Gtk.vscale
   # ========================================================================= #
   def self.vscale(optional_hash = {})
-    if is_gtk2?
+    if use_gtk2?
       scale = Gtk::VScale.new
-    else
+    elsif use_gtk3?
       scale = Gtk::Scale.new(:vertical)
     end
     # ======================================================================= #