gtk_paradise 0.9.120 → 0.12.25

data/lib/gtk_paradise/widgets/shared_code/pid_displayer/pid_displayer_module.rb

@@ -104,10 +104,7 @@ module PidDisplayerModule
     # === @configuration
     # ======================================================================= #
     @configuration = [true, __dir__, NAMESPACE]
-    # === @title
-    @title  = TITLE
-    set_height(HEIGHT)
-    set_width(WIDTH)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, FONT_TO_USE)
     # ======================================================================= #
     # === @processes
     # ======================================================================= #
@@ -120,7 +117,6 @@ module PidDisplayerModule
     # === @n_rows
     # ======================================================================= #
     @n_rows = 0 # this will tell us how many rows we have
-    set_font(FONT_TO_USE) 
     use_gtk_paradise_project_css_file
   end
 
@@ -137,24 +133,24 @@ module PidDisplayerModule
   # === create_buttons
   #
   # creates all buttons in use. buttons tag button tag
-  #
-  #   $RSRC/GUI/GTK/PID_DISPLAYER/gtk2_pid_displayer.rb
   # ========================================================================= #
   def create_buttons
-    # ========================================================================= #
+    # ======================================================================= #
     # The Quit button.
-    # ========================================================================= #
+    # ======================================================================= #
     @button_quit = gtk_button('_Quit')
+    @button_quit.clear_background
     @button_quit.modify_background(:active,   :coral)
     @button_quit.modify_background(:normal,   :chocolate)
     @button_quit.modify_background(:prelight, :yellow)
     @button_quit.on_clicked { ::Gtk.main_quit }
 
-    # ========================================================================= #
+    # ======================================================================= #
     # The kill-PID button comes next.
-    # ========================================================================= #
+    # ======================================================================= #
     @button_kill_pid = gtk_button('_Kill Pid')
-    @button_kill_pid.fancy_tooltips = 'This will kill the PID (process) '\
+    @button_kill_pid.clear_background
+    @button_kill_pid.hint = 'This will kill the PID (process) '\
       'via .kill_id(), and then update the listing via .update_listing().'
     @button_kill_pid.modify_background(:active,   :coral)
     @button_kill_pid.modify_background(:normal,   :chocolate)
@@ -166,7 +162,11 @@ module PidDisplayerModule
       update_listing # after we killed a pid, we must update the listing again
     }
 
+    # ======================================================================= #
+    # === @button_clear_list
+    # ======================================================================= #
     @button_clear_list = gtk_button('_Clear Listing')
+    @button_clear_list.clear_background
     @button_clear_list.modify_background(:active,   :coral)
     @button_clear_list.modify_background(:normal,   :chocolate)
     @button_clear_list.modify_background(:prelight, :mediumorchid)
@@ -180,6 +180,7 @@ module PidDisplayerModule
     # === Update listing
     # ======================================================================= #
     @button_update_listing = gtk_button('_Update Listing')
+    @button_update_listing.clear_background
     @button_update_listing.modify_background(:active, :coral)
     @button_update_listing.modify_background(:normal, :chocolate)
     @button_update_listing.modify_background(:prelight, :mediumorchid)
@@ -187,8 +188,11 @@ module PidDisplayerModule
       efancy 'Updating listing:'
       update_listing
     }
-
+    # ======================================================================= #
+    # === @button_grep
+    # ======================================================================= #
     @button_grep = gtk_button('_Grep')
+    @button_grep.clear_background
     @button_grep.modify_background(:active,   :coral)
     @button_grep.modify_background(:normal,   :chocolate)
     @button_grep.modify_background(:prelight, :mediumorchid)
@@ -215,29 +219,15 @@ module PidDisplayerModule
     @geometry.set_height_inc(20) if @geometry.respond_to? :set_height_inc
   end
 
-  # ==================================================================== #
+  # ========================================================================= #
   # === create_liststore
   #
   # 12 entries.
-  # ==================================================================== #
+  # ========================================================================= #
   def create_liststore
     @list_store = ::Gtk::ListStore.new(* ([String] * 12) )
   end
 
-  # ========================================================================= #
-  # === create_skeleton
-  # ========================================================================= #
-  def create_skeleton
-    create_vbox               # creates our vbox
-    create_buttons            # create our buttons
-    create_liststore          # create entries for use in treeview
-    create_treeview           # stores our liststore    
-    create_renderer           # create our renderer
-    create_scrolled_window    #
-    create_entries            # all entries
-    create_and_connect_tables # we want a table and will connect it
-  end
-
   # ========================================================================= #
   # === connect_skeleton
   #
@@ -255,47 +245,52 @@ module PidDisplayerModule
     show_all
   end
 
-  # ==================================================================== #
+  # ========================================================================= #
   # === create_vbox
-  # ==================================================================== #
+  # ========================================================================= #
   def create_vbox
     @v_box = gtk_vbox
   end
 
-  # ==================================================================== #
+  # ========================================================================= #
   # === clear_liststore
   #
   # Used to clear our liststore entries. See for Gtk::ListStore clear.
   #
   # I believe thats not the same as emptying it.
   # clear_liststore
-  # ==================================================================== #
+  # ========================================================================= #
   def clear_liststore
     @list_store.clear
   end
 
-  # ==================================================================== #
+  # ========================================================================= #
   # === create_treeview
   #
   # Creates our treeview, by using our @list_store
-  # ==================================================================== #
+  # ========================================================================= #
   def create_treeview
+    # ================================================================== #
+    # === @tree_view
+    # ================================================================== #
     @tree_view = gtk_tree_view(@list_store)
     @tree_view.set_size_request(800, 300)
+    @tree_view.resizable_headers
+    @tree_view.the_rows_are_sortable
   end
 
-  # ==================================================================== #
+  # ========================================================================= #
   # === create_renderer
-  # ==================================================================== # 
+  # ========================================================================= # 
   def create_renderer
     @renderer = gtk_cell_renderer_text
     @renderer.set_property('foreground', 'black')
     @renderer.set_property('background', 'white')
   end
 
-  # ==================================================================== #
+  # ========================================================================= #
   # === create_scrolled_window
-  # ==================================================================== #
+  # ========================================================================= #
   def create_scrolled_window
     @scrolled_window = gtk_scrolled_window
   end
@@ -436,7 +431,9 @@ module PidDisplayerModule
   # This greps for all names; note that @processes must have been set
   # properly.
   # ========================================================================= # 
-  def grep_for(input = grepping_for?)
+  def grep_for(
+      input = grepping_for?
+    )
     pp @processes
     e "Grepping for #{grepping_for?}"
     @processes.each { |entry|
@@ -450,7 +447,7 @@ module PidDisplayerModule
     end
     report_n_rows
   end
-  
+
   # ========================================================================= #
   # === create_and_connect_tables
   #
@@ -552,6 +549,20 @@ module PidDisplayerModule
     return_all_buttons.each {|this_button| this_button.bblack1 }
   end
 
+  # ========================================================================= #
+  # === create_skeleton
+  # ========================================================================= #
+  def create_skeleton
+    create_vbox               # creates our vbox
+    create_buttons            # create our buttons
+    create_liststore          # create entries for use in treeview
+    create_treeview           # stores our liststore    
+    create_renderer           # create our renderer
+    create_scrolled_window    #
+    create_entries            # all entries
+    create_and_connect_tables # we want a table and will connect it
+  end
+
   # ========================================================================= #
   # === run                                                         (run tag)
   # ========================================================================= #
@@ -583,6 +594,7 @@ module PidDisplayerModule
     require 'gtk_paradise/run.rb'
     _ = Gtk::PidDisplayer.new
     r = ::Gtk.run
+    r.set_border_width(4)
     r.shortcut('alt+1') { 'focus_on(@entry_pid_number)' }
     r.shortcut('alt+2') { 'focus_on(@entry_choose_pid)' }
     r << _

data/lib/gtk_paradise/widgets/shared_code/random_image/random_image_module.rb

@@ -24,6 +24,10 @@ module RandomImageModule
   require 'gtk_paradise/requires/require_the_base_module.rb'
   include ::Gtk::BaseModule
 
+  begin
+    require 'open'
+  rescue LoadError; end
+
   begin
     require 'colours'
     include ::Colours
@@ -54,7 +58,7 @@ module RandomImageModule
   # ========================================================================= #
   # === TITLE
   # ========================================================================= #
-  TITLE = 'Random Image'
+  TITLE = 'Random Image Viewer'
 
   # ========================================================================= #
   # === initialize
@@ -90,7 +94,7 @@ module RandomImageModule
     # ======================================================================= #
     # === @title
     # ======================================================================= #
-    @title = 'ImageViewer'
+    set_title(TITLE)
     # ======================================================================= #
     # === @width
     # ======================================================================= #
@@ -224,25 +228,6 @@ module RandomImageModule
       'button in order to load up a new (random) image.'
     @button_on_the_right_side_for_loading_a_new_image.on_clicked { reload_new_random_image }
   end
-
-  # ========================================================================= #
-  # === create_gtk_entry_on_bottom
-  #
-  # This is the gtk-entry for the box on the very bottom.
-  # ========================================================================= #
-  def create_gtk_entry_on_bottom
-    @entry_image_location = gtk_entry
-    @entry_image_location.set_max_length(100)
-    @entry_image_location.set_text(image?)
-    @entry_image_location.on_key_press_event { |widget, event|
-      _ = Gdk::Keyval.to_name(event.keyval)
-      case _
-      when 'Up','KP_Up','Down','KP_Down',
-           'Left','KP_Left','Right','KP_Right'
-        reload_new_random_image
-      end
-    }
-  end
   
   # ========================================================================= #
   # === get_image
@@ -267,16 +252,13 @@ module RandomImageModule
   # ========================================================================= #
   def connect_skeleton
     abort_on_exception
-    # @vpaned.add1(@event_box_containing_the_image)
     scrolled_window = gtk_scrolled_window(@event_box_containing_the_image) { :always }
     add(scrolled_window)
     scrolled_window.set_size_request(1200, 800)
     mini_hbox = gtk_hbox
     mini_hbox.maximal(@entry_image_location)
-    @entry_image_location.set_size_request(100, 50)
     mini_hbox.minimal(@button_on_the_right_side_for_loading_a_new_image)
-    # @vpaned.add2(mini_hbox)
-    # @vpaned.position = 1400
+    mini_hbox.minimal(return_widget_containing_the_open_in_browser_functionality)
     add(mini_hbox)
   end
 
@@ -297,11 +279,46 @@ module RandomImageModule
     _ = ::Gtk::RandomImage.new(ARGV.first)
     r = ::Gtk.run
     r << _
-    r.set_size_request(
-      _.width?,
-      _.height?
-    )
+    r.set_size_request(_.width?, _.height?)
     r.top_left_then_run
   end
 
+  # ========================================================================= #
+  # === create_gtk_entry_on_bottom
+  #
+  # This is the gtk-entry for the box on the very bottom.
+  # ========================================================================= #
+  def create_gtk_entry_on_bottom
+    # ======================================================================= #
+    # === @entry_image_location
+    # ======================================================================= #
+    @entry_image_location = gtk_entry
+    @entry_image_location.set_max_length(100)
+    @entry_image_location.set_size_request(100, 50)
+    @entry_image_location.set_text(image?)
+    @entry_image_location.on_key_press_event { |widget, event|
+      _ = Gdk::Keyval.to_name(event.keyval)
+      case _
+      when 'Up','KP_Up','Down','KP_Down',
+           'Left','KP_Left','Right','KP_Right'
+        reload_new_random_image
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === return_widget_containing_the_open_in_browser_functionality
+  # ========================================================================= #
+  def return_widget_containing_the_open_in_browser_functionality
+    _ = event_box(image_web_browser)
+    _.on_clicked {
+      if Object.const_defined? :Open
+        Open.in_browser(@entry_image_location.text?)
+      else
+        e 'Please install the "open" gem first, via: gem install open'
+      end
+    }
+    return _
+  end
+
 end; end

data/lib/gtk_paradise/widgets/shared_code/select_file/select_file_module.rb

@@ -168,7 +168,7 @@ module SelectFileModule
     # We will make use of a button to trigger the open-file functionality.
     # ======================================================================= #
     @button_select_file = gtk_button('_Select File')
-    @button_select_file.css_class('bblack2')
+    @button_select_file.bblack2
     @button_select_file.on_clicked {
       do_click_the_button_select_file
     }

data/lib/gtk_paradise/widgets/shared_code/show_icon_theme/show_icon_theme_module.rb

@@ -75,22 +75,15 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
   # ========================================================================= #
   def reset
     reset_the_internal_variables
+    infer_the_namespace
     # ======================================================================= #
     # === @configuration
     # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
+    @configuration = [true, __dir__, namespace?]
     # ======================================================================= #
-    # === @title
+    # === title, width, height and font
     # ======================================================================= #
-    set_title(TITLE)
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
     # ======================================================================= #
     # === @array_all_entries
     # ======================================================================= #
@@ -112,7 +105,6 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
     @context_menu.css_class(
       'bblack3_and_padding'
     )
-    set_font(USE_THIS_FONT)
     use_gtk_paradise_project_css_file
     infer_the_size_automatically
   end
@@ -195,12 +187,14 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
         event_box_for_the_index = gtk_event_box(index_label)
         event_box_for_the_index.on_clicked {
           set_text_for_the_search_bar.set_text(basename)
+          sync_the_text_of_the_search_bar_onto_the_icon_below_the_search_bar
         }
         hbox.minimal(event_box_for_the_index, 12)
         hbox.minimal(image, 1)
         event_box_for_the_last_label = gtk_eventbox(label)
         event_box_for_the_last_label.on_clicked {
           set_text_for_the_search_bar.set_text(basename)
+          sync_the_text_of_the_search_bar_onto_the_icon_below_the_search_bar
         }
         # label.is_selectable # Can not do this if we use an event box.
         hbox.minimal(event_box_for_the_last_label, 1)
@@ -257,6 +251,43 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
     e
   end
 
+  # ========================================================================= #
+  # === main_entry?
+  # ========================================================================= #
+  def main_entry?
+    @entry_for_the_search_bar
+  end
+
+  # ========================================================================= #
+  # === which_theme_is_in_use?
+  #
+  # This will return the current theme in use, based on the directory.
+  # ========================================================================= #
+  def which_theme_is_in_use?
+    @target_directory.split('/')[4].to_s.downcase
+  end
+
+  # ========================================================================= #
+  # === Gtk::ShowIconTheme.run
+  # ========================================================================= #
+  def self.run
+    require 'gtk_paradise/run'
+    r = ::Gtk.run
+    _ = ::Gtk::ShowIconTheme.new
+    r << _
+    r.enable_context_menu
+    r.set_my_title(
+      _.title?+' ('+_.which_theme_is_in_use?+' theme is in use)'
+    )
+    r.automatic_size
+    r.signal_connect(:button_press_event) { |widget, event|
+      if ::Gtk.right_mouse_click?(event) # right mouse click event.
+        _.context_menu?.popup_based_on_this_event(event)
+      end
+    }
+    r.top_left_then_run
+  end
+
   # ========================================================================= #
   # === create_and_return_the_search_widget
   #
@@ -274,7 +305,7 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
     # ======================================================================= #
     # Next add the search-entry.
     # ======================================================================= #
-    @entry_for_the_search_bar = gtk_entry
+    @entry_for_the_search_bar = create_entry
     @entry_for_the_search_bar.set_size_request(150, 50)
     @entry_for_the_search_bar.css_class('pad8px')
     @entry_for_the_search_bar.css_class('mar48px')
@@ -282,6 +313,8 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
     @entry_for_the_search_bar.css_class('border_3px_royalblue')
     @entry_for_the_search_bar.align_to_the_middle
     @entry_for_the_search_bar.enable_search_icon
+    # The user can use the "enter" key to trigger a specific search for
+    # a gtk-icon, such as "batter".
     @entry_for_the_search_bar.on_enter_key_clicked {
       search_term = @entry_for_the_search_bar.text?
       array = @array_all_entries
@@ -310,6 +343,14 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
       end
     }
     @search_widget.minimal(@entry_for_the_search_bar, 10)
+    sample = File.basename(@sorted_array.sample)
+    basename = sample.delete_suffix(File.extname(sample))
+    icon = DEFAULT_ICON_THEME.load_icon(basename, 32, 0) # Use the window-close example.
+    @widget_showing_which_icon_is_used = gdk_pixbuf(icon)
+    @widget_showing_which_icon_is_used.hint = 'This area '\
+      'will show which icon is currently selected as the '\
+      'default.'
+    @search_widget.minimal(@widget_showing_which_icon_is_used, 10)
     @search_widget.minimal(results_widget,            10)
     @entry_for_the_search_bar.ghost_text('Input your search term here')
     return @search_widget
@@ -325,40 +366,12 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
   end
 
   # ========================================================================= #
-  # === main_entry?
-  # ========================================================================= #
-  def main_entry?
-    @entry_for_the_search_bar
-  end
-
-  # ========================================================================= #
-  # === which_theme_is_in_use?
-  #
-  # This will return the current theme in use, based on the directory.
-  # ========================================================================= #
-  def which_theme_is_in_use?
-    @target_directory.split('/')[4].to_s.downcase
-  end
-
+  # === sync_the_text_of_the_search_bar_onto_the_icon_below_the_search_bar
   # ========================================================================= #
-  # === Gtk::ShowIconTheme.run
-  # ========================================================================= #
-  def self.run
-    require 'gtk_paradise/run'
-    r = ::Gtk.run
-    _ = ::Gtk::ShowIconTheme.new
-    r << _
-    r.enable_context_menu
-    r.set_my_title(
-      _.title?+' ('+_.which_theme_is_in_use?+' theme is in use)'
-    )
-    r.automatic_size
-    r.signal_connect(:button_press_event) { |widget, event|
-      if ::Gtk.right_mouse_click?(event) # right mouse click event.
-        _.context_menu?.popup_based_on_this_event(event)
-      end
-    }
-    r.top_left_then_run
+  def sync_the_text_of_the_search_bar_onto_the_icon_below_the_search_bar
+    _ = @entry_for_the_search_bar.text?
+    icon = DEFAULT_ICON_THEME.load_icon(_, 32, 0)
+    @widget_showing_which_icon_is_used.set_pixbuf(icon)
   end
 
 end; end

data/lib/gtk_paradise/widgets/shared_code/simple_clock/simple_clock_module.rb

@@ -73,18 +73,7 @@ module SimpleClockModule
     # === @configuration
     # ======================================================================= #
     @configuration = [true, __dir__, NAMESPACE]
-    # ======================================================================= #
-    # === @title
-    # ======================================================================= #
-    @title = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
+    title_width_height(TITLE, WIDTH, HEIGHT)
     # ======================================================================= #
     # === @use_a_small_icon_showing_a_clock
     #