gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/widgets/{version_agnostic → gtk3/button_open_remote_webpage}/button_open_remote_webpage.rb

@@ -6,24 +6,41 @@
 #
 # This button can open a remote webpage, upon the user clicking on it.
 # =========================================================================== #
-# require 'gtk_paradise/widgets/version_agnostic/button_open_remote_webpage.rb'
-# Gtk::ButtonOpenRemoteWebpage.new(ARGV)
+# require 'gtk_paradise/gui/gtk3/button_open_remote_webpage/button_open_remote_webpage.rb'
+# Gtk::ButtonOpenRemoteWebpage.run(ARGV)
 # =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
 module Gtk
 
-class ButtonOpenRemoteWebpage < ::Gtk::Button
+class ButtonOpenRemoteWebpage < ::Gtk::Button # === Gtk::ButtonOpenRemoteWebpage
+
+  begin
+    require 'open'
+  rescue LoadError; end
 
   require 'gtk_paradise/requires/require_the_base_module.rb'
   include ::Gtk::BaseModule
 
-  begin
-    require 'open_in_browser'
-  rescue LoadError; end
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Button open remote webpage'
 
   # ========================================================================= #
-  # === NAMESPACE
+  # === WIDTH
   # ========================================================================= #
-  NAMESPACE = inspect
+  WIDTH = '25% or minimum 200px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '10% or minimum 100px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_20
 
   # ========================================================================= #
   # === DEFAULT_URL
@@ -33,21 +50,19 @@ class ButtonOpenRemoteWebpage < ::Gtk::Button
   # ========================================================================= #
   DEFAULT_URL = 'https://www.youtube.com/watch?v=-VAKfwCem68'
 
-  # ========================================================================= #
-  # === HEIGHT
-  # ========================================================================= #
-  HEIGHT = 100
-
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
   def initialize(
-      i           = ARGV,
-      run_already = true
+      commandline_arguments = ARGV,
+      run_already           = true
     )
     super()
     reset
-    set_remote_webpage(i)
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    set_remote_webpage(commandline_arguments)
     set_label(return_modified_label_based_on_the_remote_webpage)
     # ======================================================================= #
     # === Handle blocks given next
@@ -66,24 +81,57 @@ class ButtonOpenRemoteWebpage < ::Gtk::Button
   end
 
   # ========================================================================= #
-  # === reset
+  # === reset                                                     (reset tag)
   # ========================================================================= #
   def reset
     reset_the_internal_variables
+    infer_the_namespace
     # ======================================================================= #
     # === @configuration
     # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
+    @configuration = [true, __dir__, namespace?]
     # ======================================================================= #
-    # === @height
+    # === Set the title, width, height and the font in use.
     # ======================================================================= #
-    set_height(HEIGHT)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    use_gtk_paradise_project_css_file  
+    infer_the_size_automatically
     # ======================================================================= #
     # === @remote_webpage
     # ======================================================================= #
     @remote_webpage = nil
-    set_font_in_use_for_this_application :dejavu_20
-    use_gtk_paradise_project_css_file
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    4
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === respond_to_the_button_clicked_action
+  # ========================================================================= #
+  def respond_to_the_button_clicked_action(
+      use_this_url = @remote_webpage
+    )
+    on_clicked {
+      Open.in_browser(use_this_url)
+    }
+  end
+
+  # ========================================================================= #
+  # === return_modified_label_based_on_the_remote_webpage
+  # ========================================================================= #
+  def return_modified_label_based_on_the_remote_webpage
+    "➡️ #{@remote_webpage}"
   end
 
   # ========================================================================= #
@@ -111,13 +159,6 @@ class ButtonOpenRemoteWebpage < ::Gtk::Button
     @remote_webpage = i
   end
 
-  # ========================================================================= #
-  # === return_modified_label_based_on_the_remote_webpage
-  # ========================================================================= #
-  def return_modified_label_based_on_the_remote_webpage
-    "➡️ #{@remote_webpage}"
-  end
-
   # ========================================================================= #
   # === which_url?
   # ========================================================================= #
@@ -129,26 +170,21 @@ class ButtonOpenRemoteWebpage < ::Gtk::Button
   # === determine_the_tooltips_in_use
   # ========================================================================= #
   def determine_the_tooltips_in_use
-    self.fancy_tooltips = 'Click on this button to '\
-                          'open the URL at <b>'+
-                          which_url?.to_s+'</b>.'
+    self.hint = "Click on this button to open the URL at <b>"\
+                "#{which_url?}</b>."
   end
 
   # ========================================================================= #
-  # === respond_to_the_button_clicked_action
+  # === create_skeleton                            (create tag, skeleton tag)
   # ========================================================================= #
-  def respond_to_the_button_clicked_action(
-      use_this_url = @remote_webpage
-    )
-    on_clicked {
-      Open.in_browser(use_this_url)
-    }
+  def create_skeleton
   end
 
   # ========================================================================= #
-  # === run
+  # === connect_skeleton                                        (connect tag)
   # ========================================================================= #
-  def run
+  def connect_skeleton
+    abort_on_exception
     set_name('button1')
     determine_the_tooltips_in_use
     disallow_resizing
@@ -156,16 +192,35 @@ class ButtonOpenRemoteWebpage < ::Gtk::Button
     respond_to_the_button_clicked_action
   end
 
-end; end
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    create_skeleton_then_connect_skeleton
+  end
 
-if __FILE__ == $PROGRAM_NAME
   # ========================================================================= #
-  # Determine which ruby-gtk version to use.
+  # === Gtk::ButtonOpenRemoteWebpage.run
   # ========================================================================= #
-  require 'gtk_paradise/require_gtk3'
-  require 'gtk_paradise/run'
-  r = Gtk.run
-  r << Gtk::ButtonOpenRemoteWebpage.new(:default_url) { :make_bold }
-  r.set_default_size(120, 60)
-  r.top_left_then_run
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/app/app.rb'
+    if i.is_a? Array
+      i = i.first
+    end
+    if i.nil? or i.empty?
+      i = :default_url
+    end
+    _ = ::Gtk::ButtonOpenRemoteWebpage.new(i) { :make_bold }
+    r = ::Gtk.run
+    r << _
+    r.automatic_size_then_automatic_title
+    r.top_left_then_run
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Gtk::ButtonOpenRemoteWebpage.run
 end # ButtonOpenRemoteWebpage

data/lib/gtk_paradise/widgets/gtk3/button_with_border/button_with_border.rb

@@ -0,0 +1,155 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Gtk::ButtonWithBorder
+#
+# This button has to display a coloured border around itself.
+#
+# Essentially the "base" is that of a gtk-frame.
+# =========================================================================== #
+# require 'gtk_paradise/gui/gtk3/button_with_border/button_with_border.rb'
+# Gtk::ButtonWithBorder.run
+# =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
+module Gtk
+
+class ButtonWithBorder < ::Gtk::Frame # === Gtk::ButtonWithBorder 
+
+  require 'gtk_paradise/requires/require_the_base_module.rb'
+  include ::Gtk::BaseModule
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Button with border'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '25% or minimum 200px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '15% or minimum 100px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_20
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV,
+      run_already           = true
+    )
+    super()
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    set_border_colour
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    reset_the_internal_variables
+    infer_the_namespace
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    # ======================================================================= #
+    # === Set the title, width, height and the font in use.
+    # ======================================================================= #
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    use_gtk_paradise_project_css_file # or use use_project_css_file 
+    infer_the_size_automatically
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    4
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                            (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_skeleton
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton                                        (connect tag)
+  # ========================================================================= #
+  def connect_skeleton
+  end
+
+  # ========================================================================= #
+  # === set_border_colour
+  #
+  # Designate the colour of the border to use via this method. By default
+  # this will be in the colour "steelblue".
+  # ========================================================================= #
+  def set_border_colour(i = :default)
+    case i
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default
+      i = :steelblue
+    end
+    @border_colour = i.to_sym
+  end; alias set_border_color set_border_colour # === set_border_color
+       alias border_colour=   set_border_colour # === border_colour=
+       alias border_color=    set_border_colour # === border_color=
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    create_skeleton_then_connect_skeleton
+    if respond_to? :modify_background
+      modify_background(:normal, @border_colour)
+      set_shadow_type(:in)
+    else
+      override_background_colour(:normal, @border_colour)
+      set_shadow_type(:in)
+    end
+  end
+
+  # ========================================================================= #
+  # === Gtk::ButtonWithBorder.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/app/app.rb'
+    _ = ::Gtk::ButtonWithBorder.new(i)
+    r = ::Gtk.run
+    r << _
+    r.automatic_size_then_automatic_title
+    # r.enable_quick_exit
+    r.top_left_then_run
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Gtk::ButtonWithBorder.run
+end

data/lib/gtk_paradise/widgets/{version_agnostic → gtk3/button_xorg_buffer}/button_xorg_buffer.rb

@@ -4,13 +4,15 @@
 # =========================================================================== #
 # === Gtk::ButtonXorgBuffer
 # =========================================================================== #
-# require 'gtk_paradise/widgets/version_agnostic/button_xorg_buffer.rb'
+# require 'gtk_paradise/widgets/gtk3/button_xorg_buffer/button_xorg_buffer.rb'
 # button_xorg_buffer = Gtk::ButtonXorgBuffer.new
 # button_xorg_buffer = Gtk::ButtonXorgBuffer.new('Test_cyan')
 # =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
 module Gtk
 
-class ButtonXorgBuffer < ::Gtk::Button # === Gtk::ButtonXorgBuffer
+class ButtonXorgBuffer < ::Gtk::Button # === Gtk::ButtonXorgBuffer 
 
   require 'gtk_paradise/requires/require_the_base_module.rb'
   include ::Gtk::BaseModule
@@ -19,16 +21,26 @@ class ButtonXorgBuffer < ::Gtk::Button # === Gtk::ButtonXorgBuffer
     require 'xorg_buffer'
   rescue LoadError; end
 
-  begin
-    require 'colours'
-    include Colours # This should also include HtmlColours.
-  rescue LoadError; end
-
   # ========================================================================= #
   # === TITLE
   # ========================================================================= #
   TITLE = 'Assign to the Xorg-Buffer'
 
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '10% or minimum 50px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '10% or minimum 50px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_18
+
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
@@ -41,7 +53,7 @@ class ButtonXorgBuffer < ::Gtk::Button # === Gtk::ButtonXorgBuffer
       if optional_connect_to_this_widget.is_a? Hash
         _ = optional_connect_to_this_widget
         if _.has_key? :label
-          @title = _.delete(:label)
+          set_title(_.delete(:label))
         end
       else
         # =================================================================== #
@@ -50,8 +62,8 @@ class ButtonXorgBuffer < ::Gtk::Button # === Gtk::ButtonXorgBuffer
         @connect_to_this_widget = optional_connect_to_this_widget
       end
     end
-    self.fancy_tooltips = '<b>Click</b> on this button to '\
-      'assign to the <b>xorg-buffer</b>.'
+    self.hint = '<b>Click</b> on this button to '\
+                'assign to the <b>xorg-buffer</b>.'
     on_clicked {
       do_assign_this_text_to_the_xorg_buffer
     }
@@ -71,14 +83,32 @@ class ButtonXorgBuffer < ::Gtk::Button # === Gtk::ButtonXorgBuffer
     set_label(@title)
   end
 
+  # ========================================================================= #
+  # === set_title
+  # ========================================================================= #
+  def set_title(i)
+    if i.is_a? Array
+      i = i.join(' ').strip
+    end
+    @title = i.dup
+  end
+
   # ========================================================================= #
   # === reset                                                     (reset tag)
   # ========================================================================= #
   def reset
+    reset_the_internal_variables
+    infer_the_namespace
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
     # ======================================================================= #
-    # === @title
+    # === Set the title, width, height and the font in use.
     # ======================================================================= #
-    @title = TITLE.dup
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    use_gtk_paradise_project_css_file 
+    infer_the_size_automatically
     # ======================================================================= #
     # === @connect_to_this_widget
     # ======================================================================= #
@@ -97,15 +127,32 @@ class ButtonXorgBuffer < ::Gtk::Button # === Gtk::ButtonXorgBuffer
     @this_text = ''.dup
   end
 
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    4
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
   # ========================================================================= #
   # === set_this_text
   # ========================================================================= #
   def set_this_text(i)
+    if i.is_a? Array
+      i = i.join(' ').strip
+    end
     @this_text = i
   end; alias assign_this_text set_this_text # === assign_this_text
 
   # ========================================================================= #
-  # === attach
+  # === attach                                                   (attach tag)
   #
   # This method does a set_this_text() call before then calling
   # do_assign_this_text_to_the_xorg_buffer().
@@ -139,12 +186,23 @@ class ButtonXorgBuffer < ::Gtk::Button # === Gtk::ButtonXorgBuffer
     end
   end
 
+  # ========================================================================= #
+  # === Gtk::ButtonXorgBuffer.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/app/app.rb'
+    _ = Gtk::ButtonXorgBuffer.new
+    _.attach(i) if i and !i.empty?
+    r = ::Gtk.run
+    r << _
+    r.automatic_size_then_automatic_title
+    r.top_left_then_run
+  end
+
 end; end
 
 if __FILE__ == $PROGRAM_NAME
-  require 'gtk_paradise/require_gtk3'
-  require 'gtk_paradise/run'
-  r = Gtk.run
-  r << Gtk::ButtonXorgBuffer.new 
-  r.top_left_then_run
+  Gtk::ButtonXorgBuffer.run('Testing 123')
 end