gtk_paradise 0.9.120 → 0.11.19

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

@@ -80,17 +80,9 @@ module ShowIconThemeModule # === Gtk::ShowIconThemeModule
     # ======================================================================= #
     @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 +104,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 +186,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 +250,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
   #
@@ -282,6 +312,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 +342,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 +365,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
     #

data/lib/gtk_paradise/widgets/shared_code/stopwatch/stopwatch_module.rb

@@ -1,341 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# === Gtk::StopwatchModule
-# =========================================================================== #
-# require 'gtk_paradise/widgets/shared_code/stopwatch/stopwatch_module.rb'
-# include ::Gtk::StopwatchModule
-# =========================================================================== #
-module Gtk
-
-module StopwatchModule
-
-  require 'gtk_paradise/requires/require_the_base_module.rb'
-  include ::Gtk::BaseModule
-
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
-  # ========================================================================= #
-  # === TITLE
-  # ========================================================================= #
-  TITLE = 'Stopwatch'
-
-  # ========================================================================= #
-  # === DEFAULT_LABEL_TEXT
-  # ========================================================================= #
-  DEFAULT_LABEL_TEXT = '00:00:00.0'
-
-  # ========================================================================= #
-  # === WIDTH
-  # ========================================================================= #
-  WIDTH  = 1440
-
-  # ========================================================================= #
-  # === HEIGHT
-  # ========================================================================= #
-  HEIGHT =  280
-
-  # ========================================================================= #
-  # === initialize
-  # ========================================================================= #
-  def initialize(
-      run_already   = true
-    )
-    super(:vertical, 2)
-    reset
-    run if run_already
-  end
-
-  # ========================================================================= #
-  # === reset                                                     (reset tag)
-  # ========================================================================= #
-  def reset
-    reset_the_internal_variables
-    # ======================================================================= #
-    # === @configuration
-    # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
-    # ======================================================================= #
-    # === @title
-    # ======================================================================= #
-    @title  = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    # ======================================================================= #
-    # === @accumulated
-    # ======================================================================= #
-    reset_accumulated
-    # ======================================================================= #
-    # === @elapsed
-    # ======================================================================= #
-    @elapsed = 0
-    # ======================================================================= #
-    # === @array_all_buttons
-    # ======================================================================= #
-    @array_all_buttons = []
-    set_use_this_font(:dejavu_condensed_22)
-    do_stop_the_stopwatch_counter
-    use_gtk_paradise_project_css_file
-    infer_the_size_automatically
-  end
-
-  # ========================================================================= #
-  # === padding?
-  # ========================================================================= #
-  def padding?
-    12
-  end
-
-  # ========================================================================= #
-  # === Stopwatch.width?
-  # ========================================================================= #
-  def self.width?
-    WIDTH
-  end
-
-  # ========================================================================= #
-  # === Stopwatch.height?
-  # ========================================================================= #
-  def self.height?
-    HEIGHT
-  end
-
-  # ========================================================================= #
-  # === populate_and_then_colourize_the_array_containing_the_buttons
-  # ========================================================================= #
-  def populate_and_then_colourize_the_array_containing_the_buttons
-    @array_all_buttons << @button_start << @button_stop << @button_reset
-    @array_all_buttons.each {|this_button|
-      this_button.lightblue
-    }
-  end
-
-  # ========================================================================= #
-  # === favicon?
-  # ========================================================================= #
-  def favicon?
-    :tabble
-  end
-
-  # ========================================================================= #
-  # === border_size?
-  # ========================================================================= #
-  def border_size?
-    2
-  end
-
-  # ========================================================================= #
-  # === create_buttons                                          (buttons tag)
-  # ========================================================================= #
-  def create_buttons
-    # ======================================================================= #
-    # The "start the count-down" button:
-    # ======================================================================= #
-    @button_start = gtk_button('_Start')
-    @button_start.fancy_tooltips = ' <b>Start</b> the stopwatch counter '
-    @button_start.on_clicked {
-      do_start_the_stopwatch_counter
-      @button_start.toggle_grey
-      @button_stop.toggle_grey
-    }
-    # ======================================================================= #
-    # The stop-button:
-    # ======================================================================= #
-    @button_stop = gtk_button('S_top')
-    @button_stop.fancy_tooltips = ' <b>Stop</b> the stopwatch counter '
-    @button_stop.on_clicked {
-      do_stop_the_stopwatch_counter
-      @button_start.toggle_grey
-      @button_stop.toggle_grey
-      change_the_label_of_the_start_button_to_resume
-    }
-    @button_stop.grey_out
-    # ======================================================================= #
-    # The reset-button:
-    # ======================================================================= #
-    @button_reset = gtk_button('_Reset')
-    @button_reset.fancy_tooltips = ' <b>Reset</b> the stopwatch to its initial (startup) state '
-    @button_reset.on_clicked {
-      do_reset_the_main_label
-      do_stop_the_stopwatch_counter
-      reset_accumulated
-      initial_grey_state
-      change_the_label_of_the_start_button_to_start
-    }
-    array_buttons = [
-      @button_start,
-      @button_stop,
-      @button_reset
-    ]
-    array_buttons.each {|entry|
-      entry.enable_markup
-      entry.css_class('bblack2')
-    }
-  end
-
-  # ========================================================================= #
-  # === do_reset_the_main_label
-  # ========================================================================= #
-  def do_reset_the_main_label
-    label?.set_text(return_default_label_text)
-  end
-
-  # ========================================================================= #
-  # === return_default_label_text
-  # ========================================================================= #
-  def return_default_label_text
-    DEFAULT_LABEL_TEXT
-  end
-
-  # ========================================================================= #
-  # === initial_grey_state
-  # ========================================================================= #
-  def initial_grey_state
-    @button_start.grey_in
-    @button_stop.grey_out
-  end
-
-  # ========================================================================= #
-  # === change_the_label_of_the_start_button_to_resume
-  # ========================================================================= #
-  def change_the_label_of_the_start_button_to_resume
-    @button_start.set_text('R_esume')
-  end
-
-  # ========================================================================= #
-  # === change_the_label_of_the_start_button_to_start
-  # ========================================================================= #
-  def change_the_label_of_the_start_button_to_start
-    @button_start.set_text('Start')
-  end
-
-  # ========================================================================= #
-  # === do_stop_the_stopwatch_counter
-  # ========================================================================= #
-  def do_stop_the_stopwatch_counter
-    @timer_stopped = true
-    @accumulated += @elapsed
-  end
-
-  # ========================================================================= #
-  # === reset_accumulated
-  # ========================================================================= #
-  def reset_accumulated
-    @accumulated = 0
-  end
-
-  # ========================================================================= #
-  # === do_start_the_stopwatch_counter
-  # ========================================================================= #
-  def do_start_the_stopwatch_counter
-    @accumulated ||= 0
-    @elapsed = 0
-    @start_time = Time.now # "Capture" the time here.
-    @timer_stopped = false
-    @timer = Thread.new {
-      until @timer_stopped do
-        sleep(0.1)
-        tick unless @timer_stopped
-      end
-    }
-  end
-
-  # ========================================================================= #
-  # === label?
-  # ========================================================================= #
-  def label?
-    @label_showing_the_time
-  end
-
-  # ========================================================================= #
-  # === create_labels                                 (labels tag, label tag)
-  # ========================================================================= #
-  def create_labels
-    @label_showing_the_time = gtk_label(DEFAULT_LABEL_TEXT)
-    @label_showing_the_time.set_size_request(400, 50)
-    @label_showing_the_time.align_to_the_left
-  end
-
-  # ========================================================================= #
-  # === tick
-  #
-  # This is the method that is called for keeping track of the time that
-  # has passed, in seconds.
-  # ========================================================================= #
-  def tick
-    @elapsed = Time.now - @start_time
-    time = @accumulated + @elapsed # This will be in n seconds.
-    # ======================================================================= #
-    # Format the time data next:
-    # ======================================================================= #
-    h  = sprintf("\%02i", (time.to_i / 3600))
-    m  = sprintf("\%02i", ((time.to_i % 3600) / 60))
-    s  = sprintf("\%02i", (time.to_i % 60))
-    mt = sprintf("\%1i", ((time - time.to_i) * 10).to_i)
-    label?.set_text(h+':'+m+':'+s+'.'+mt)
-  end
-
-  # ========================================================================= #
-  # === connect_skeleton                                        (connect tag)
-  # ========================================================================= #
-  def connect_skeleton
-    abort_on_exception
-    hbox_with_buttons = gtk_hbox
-    hbox_with_buttons.minimal(@button_start)
-    hbox_with_buttons.minimal(@button_stop)
-    hbox_with_buttons.minimal(@button_reset)
-    vbox = gtk_vbox
-    vbox.add(@label_showing_the_time)
-    vbox.minimal(hbox_with_buttons, 8)
-    # ======================================================================= #
-    # === Add an expander next.
-    # ======================================================================= #
-    expander = gtk_expander('Stopwatch')
-    expander.is_expanded
-    expander.attach_to_this_widget(vbox)
-    maximal(expander, 5)
-  end
-
-  # ========================================================================= #
-  # === create_skeleton
-  # ========================================================================= #
-  def create_skeleton
-    create_labels
-    create_buttons
-  end
-
-  # ========================================================================= #
-  # === run                                                         (run tag)
-  # ========================================================================= #
-  def run
-    create_skeleton
-    populate_and_then_colourize_the_array_containing_the_buttons
-    connect_skeleton
-  end
-
-  # ========================================================================= #
-  # === Gtk::StopwatchModule.run
-  # ========================================================================= #
-  def self.run(
-      i = ARGV
-    )
-    require 'gtk_paradise/run'
-    _ = ::Gtk::Stopwatch.new(i)
-    r = ::Gtk.run
-    r << _
-    r.set_title(_.title?)
-    r.set_size_request(_.width?, _.height?)
-    r.top_left_then_run
-  end
-
-end; end