gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/examples/advanced/003_html_like_support.rb

@@ -62,16 +62,7 @@ class HtmlLikeSupport < ::Gtk::Box
     # ======================================================================= #
     # === @title
     # ======================================================================= #
-    @title  = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    set_use_this_font(:dejavu_condensed_22)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, :dejavu_condensed_22)
     use_gtk_paradise_project_css_file
     infer_the_size_automatically
     # ======================================================================= #
@@ -97,7 +88,7 @@ class HtmlLikeSupport < ::Gtk::Box
   # === padding?
   # ========================================================================= #
   def padding?
-    2
+    4
   end
 
   # ========================================================================= #
@@ -132,19 +123,7 @@ class HtmlLikeSupport < ::Gtk::Box
     button1.css_class 'blightgreen5'
     button1.disallow_resizing
 
-    button2 = gtk_button('Button #2')
-    button2.width_height(30, 30)
-    button2.css_class 'bblack5'
-    button2.disallow_resizing
-
-    button3 = gtk_button('Button #3')
-    button3.width_height(30, 30)
-    button3.css_class 'bgreen5'
-    button3.disallow_resizing
-
     minimal(button1, 3)
-    minimal(button2, 3)
-    minimal(button3, 3)
     minimal(text('Next, showing a transparent widget'))
     button4 = gtk_button('Button #4')
     button4.width_height(30, 30)
@@ -163,12 +142,12 @@ class HtmlLikeSupport < ::Gtk::Box
     text = gtk_text('Yoda Text')
     text.css_class('BG_Black')
     text.css_class('yoda')
-    text.css_class('pad8px')
+    text.pad8px
     text.make_selectable
     minimal(text, 3)
 
     p {
-      gtk_label 'Der Meeresboden ist mit Haifischzähnen übersät weil sie '\
+      selectable_label 'Der Meeresboden ist mit Haifischzähnen übersät weil sie '\
       'aus einer der härtesten biologischen Substanzen besteht.'
     }
 

data/lib/gtk_paradise/examples/advanced/004_on_hover_example_on_gtk_entry.rb

@@ -21,17 +21,18 @@ r.use_this_font(:hack_30)
 hbox = Gtk.vbox
 Gtk.project_css_file
 
-hbox.css_class('pad8px')
+hbox.pad8px
 hbox.show_all
 
 entry1 = Gtk.entry('')
+# entry1.on_click_colour_change_to_this_colour(:steelblue, { duration: 3 })
 entry1.enable_all_events
 entry1.signal_connect(:event) {|widget, event|
 
   if  event.event_type.name == 'GDK_ENTER_NOTIFY' # on-mouse-hover
     entry1.clear_background
-    entry1.remove_css_class('royalblue')
-    entry1.css_class('tomato')
+    entry1.remove_css_class('royalblue') # Remove the old CSS class.
+    entry1.css_class('tomato')           # Add the new CSS class.
     Thread.new {
       sleep(DELAY_FOR_N_SECONDS)
       entry1.remove_css_class('tomato')
@@ -70,7 +71,6 @@ entry2.background(:tomato)
 entry2.css_class('black')
 hbox.pack_start(entry2, expand: true, fill: true, padding: 6)
 
-
 scrolled_window = Gtk.scrolled_window(hbox) { :always }
 scrolled_window.width_height(700, 200)
 r << scrolled_window

data/lib/gtk_paradise/examples/advanced/005_csv_example.rb

@@ -2,7 +2,7 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# require 'gtk_paradise/example/advanced/csv_example.rb'
+# require 'gtk_paradise/example/advanced/005_csv_example.rb'
 # =========================================================================== #
 require 'gtk_paradise/require_gtk3'
 require 'gtk_paradise/run'
@@ -12,13 +12,17 @@ require 'gtk_paradise/toplevel_methods/css.rb'
 r = Gtk.run
 r.increase_font_size
 hbox = Gtk.hbox
+# =========================================================================== #
+# Read in the .csv file next:
+# =========================================================================== #
 tree_view = Gtk.read_in_from_this_csv_file(:default, :default, :strip_quotes)
 tree_view.the_headers_are_resizable
 Gtk.gtk_paradise_css_file
 hbox.maximal(tree_view, 10)
-hbox.css_class('bblack3')
+hbox.bblack3
 hbox.show_all
 scrolled_window = Gtk.scrolled_window(hbox) { :always }
 r << scrolled_window
 r.modify_background(:normal, :white)
+r.width_height(800, 500)
 r.top_left_then_run

data/lib/gtk_paradise/examples/advanced/007_label_responding_to_events_example.rb

@@ -68,16 +68,7 @@ class LabelRespondingToEventsExample < ::Gtk::Box
     # ======================================================================= #
     # === @title
     # ======================================================================= #
-    @title  = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    set_use_this_font(USE_THIS_FONT)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
     use_gtk_paradise_project_css_file
     infer_the_size_automatically
   end

data/lib/gtk_paradise/examples/advanced/008_options_example.rb

@@ -6,7 +6,7 @@
 # =========================================================================== #
 require 'gtk_paradise/require_gtk3'
 require 'gtk_paradise/run'
-require 'gtk_paradise/toplevel_methods/misc.rb'
+require 'gtk_paradise/toplevel_methods/toplevel_methods.rb'
 require 'gtk_paradise/toplevel_methods/css.rb'
 require 'gtk_paradise/gtk_classes/radio_button.rb'
 
@@ -27,15 +27,18 @@ vbox, array_radio_buttons = ::Gtk.options(
   'choice 10'
   ]
 )
-vbox.css_class('bblack3')
+vbox.bblack3
 vbox.show_all
 scrolled_window = Gtk.scrolled_window(vbox) { :always }
 scrolled_window.set_size_request(500, 300)
 vbox = Gtk.vbox
 vbox.maximal(scrolled_window, 15)
+vbox.set_border_width(10)
 button = Gtk.button('Output the current selection')
+button.remove_background
 button.bblack2
-button.css_class('pad2px')
+button.pad2px
+button.on_hover_colour(:lightblue)
 button.on_clicked {
   _ = array_radio_buttons.select {|entry| entry.active? }
   _ = _.first if _.is_a? Array

data/lib/gtk_paradise/examples/advanced/009_key_events.rb

@@ -50,7 +50,7 @@ class KeyEvents < ::Gtk::Box
     @entry = gtk_entry
     @entry.disallow_resizing
     @entry.set_size_request(300, 300)
-    @entry.css_class('bblack2')
+    @entry.bblack2
     @entry.signal_connect(:event) {|widget, event|
       _ = event.event_type.name.to_s
       case _

data/lib/gtk_paradise/examples/advanced/010_extensive_text_view_example.rb

@@ -68,16 +68,7 @@ class ExtensiveTextViewExample < ::Gtk::Box
     # ======================================================================= #
     # === @title
     # ======================================================================= #
-    @title  = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    set_use_this_font(USE_THIS_FONT)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
     gtk_paradise_project_file 
     infer_the_size_automatically
   end
@@ -86,20 +77,29 @@ class ExtensiveTextViewExample < ::Gtk::Box
   # === padding?
   # ========================================================================= #
   def padding?
-    0
+    6
   end
 
   # ========================================================================= #
   # === border_size?
   # ========================================================================= #
   def border_size?
-    0
+    4
   end
 
   # ========================================================================= #
   # === create_skeleton                                          (create tag)
   # ========================================================================= #
   def create_skeleton
+    create_the_text_buffer
+  end
+
+  # ========================================================================= #
+  # === create_the_text_buffer
+  # ========================================================================= #
+  def create_the_text_buffer
+    @text_buffer = gtk_text_buffer("Testing one two three\n" * 50)
+    @text_buffer.read_only
   end
 
   # ========================================================================= #
@@ -107,26 +107,27 @@ class ExtensiveTextViewExample < ::Gtk::Box
   # ========================================================================= #
   def connect_skeleton
     abort_on_exception
-    label = gtk_left_aligned_label(
+    label = left_aligned_label(
       'This tests a few things in regards to a <b>gtk-text-view widget</b>.'
     )
     label.do_markify
     minimal(label, 2)
-    @text_buffer = gtk_text_buffer("Testing one two three\n"*50)
-    @text_buffer.read_only
     @text_view = gtk_text_view(@text_buffer)
     scrolled_window = gtk_scrolled_window(@text_view) { :only_top_to_bottom }
     scrolled_window.bblack2
     scrolled_window.width_height(800, 800)
     scrolled_window.set_border_width(25)
     add(scrolled_window)
-    button_get_selection = gtk_bold_button('_Get selection')
+    button_get_selection = bold_button('_Get selection')
+    button_get_selection.clear_background
     button_get_selection.bblack2
+    button_get_selection.on_hover_colour(:lightgreen)
     button_get_selection.on_clicked {
       # ===================================================================== #
       # Simply show the selected text in this case.
       # ===================================================================== #
-      e ::Colours.steelblue(@text_buffer.selected_text?)
+      selected_text = @text_buffer.selected_text?.to_s
+      e ::Colours.steelblue(selected_text)
     }
     hbox = gtk_hbox
     hbox.minimal(button_get_selection, 2)

data/lib/gtk_paradise/examples/advanced/011_moving_blocks_example.rb

@@ -9,7 +9,7 @@
 require 'gtk_paradise/require_gtk3'
 require 'gtk_paradise/requires/require_the_base_module.rb'
 require 'gtk_paradise/run'
-require 'gtk_paradise/toplevel_methods/misc.rb'
+require 'gtk_paradise/toplevel_methods/toplevel_methods.rb'
 require 'gtk_paradise/toplevel_methods/css.rb'
 require 'gtk_paradise/gtk_classes/radio_button.rb'
 require 'gtk_paradise/gtk_classes/widget.rb'
@@ -33,14 +33,14 @@ fixed.set_size_request(440, 440)
 N_ITERATIONS = 15
 
 @vbox = Gtk.vbox
-@vbox.css_class('bblack3')
+@vbox.bblack3
 @vbox.css_class('BG_blue')
 @vbox.show_all
 @vbox.set_size_request(50, 50)
 @vbox.background_color(:royalblue)
 
 @vbox2 = Gtk.vbox
-@vbox2.css_class('bblack3')
+@vbox2.bblack3
 @vbox2.css_class('BG_green')
 @vbox2.show_all
 @vbox2.set_size_request(50, 50)

data/lib/gtk_paradise/examples/advanced/012_cell_data_sorting_example.rb

@@ -8,8 +8,7 @@
 # =========================================================================== #
 require 'gtk_paradise/require_gtk3'
 require 'gtk_paradise/run'
-require 'gtk_paradise/toplevel_methods/misc.rb'
-require 'gtk_paradise/toplevel_methods/css.rb'
+require 'gtk_paradise/toplevel_methods/toplevel_methods.rb'
 require 'gtk_paradise/gtk_classes/radio_button.rb'
 require 'gtk_paradise/gtk_classes/tree_view.rb'
 
@@ -34,7 +33,7 @@ def custom_cell_data_func(
   red   = (text[1, 3]* 16).to_f / 255
   green = (text[3, 5]* 16).to_f / 255
   blue  = (text[5, 7]* 16).to_f / 255
-  renderer.props.background_rgba = Gdk::RGBA.new(red=red, green=green, blue=blue, alpha=1.0)
+  renderer.props.background_rgba = Gdk::RGBA.new(red = red, green = green, blue=blue, alpha=1.0)
   renderer.props.text = text
 end
 
@@ -70,7 +69,7 @@ column.set_cell_data_func(
 treeview.set_model(store)
 scrolled_window = Gtk.scrolled_window(treeview) { :automatic }
 scrolled_window.add(treeview)
-scrolled_window.css_class('bblack3')
+scrolled_window.bblack3
 scrolled_window.set_size_request(500, 300)
 r.add(scrolled_win)
 r << vbox

data/lib/gtk_paradise/examples/advanced/013_advanced_css_example.rb

@@ -28,7 +28,7 @@ class AdvancedCssExample < ::Gtk::Box
   # ========================================================================= #
   # === WIDTH
   # ========================================================================= #
-  WIDTH = 1280
+  WIDTH = '50% or 800px'
 
   # ========================================================================= #
   # === HEIGHT
@@ -41,48 +41,9 @@ class AdvancedCssExample < ::Gtk::Box
   USE_THIS_FONT = :dejavu_condensed_22
 
   # ========================================================================= #
-  # === initialize
+  # === USE_THESE_CSS_RULES
   # ========================================================================= #
-  def initialize(
-      commandline_arguments = ARGV,
-      run_already           = true
-    )
-    super(:vertical)
-    reset
-    set_commandline_arguments(
-      commandline_arguments
-    )
-    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)
-    set_use_this_font(USE_THIS_FONT)
-    use_gtk_paradise_project_css_file
-    infer_the_size_automatically
-    # ======================================================================= #
-    # Add more CSS next:
-    # ======================================================================= #
-    more_CSS_then_apply_it '
+  USE_THESE_CSS_RULES = '
 .blightgreen5 { border: 8px solid lightgreen; }
 .bblack5      { border: 8px solid black; }
 .bgreen5      { border: 8px solid green; }
@@ -96,7 +57,7 @@ class AdvancedCssExample < ::Gtk::Box
 }
 
 .hover1 {
-  font-size: 80px;
+  font-size: 50px;
   background-image: none;
   border: 2px solid black;
 }
@@ -139,14 +100,74 @@ class AdvancedCssExample < ::Gtk::Box
 }
 
 
+.background_for_a_fancy_hover_button_effect {
+  background: rgb(242,93,9);
+  background: linear-gradient(180deg, rgba(242,93,9,1) 0%, rgba(243,255,0,1) 100%);
+  margin: 30px;
+  padding: 20px;
+  border-radius: 10px;
+  box-shadow: 0 0 10px rgba(0,0,0,.5);
+}
+
+.background_for_a_fancy_hover_button_effect button {
+  background: palevioletred;
+  color: black;
+  border: 4px solid gold;
+  transition: all 600ms ease-in-out;
+}
+
+.background_for_a_fancy_hover_button_effect button:hover {
+  box-shadow: 0 0 10px steelblue;
+  padding: 10px 20px;
+  font-size: 150%;
+}
+
+
+
+
 '
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV,
+      run_already           = true
+    )
+    super(:vertical)
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    reset_the_internal_variables
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, NAMESPACE]
+    # ======================================================================= #
+    # === @title
+    # ======================================================================= #
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    use_gtk_paradise_project_css_file
+    infer_the_size_automatically
+    # ======================================================================= #
+    # Add more CSS next:
+    # ======================================================================= #
+    more_CSS USE_THESE_CSS_RULES
   end
 
   # ========================================================================= #
   # === padding?
   # ========================================================================= #
   def padding?
-    2
+    4
   end
 
   # ========================================================================= #
@@ -206,15 +227,17 @@ class AdvancedCssExample < ::Gtk::Box
     # ======================================================================= #
     # === Yoda text:
     # ======================================================================= #
-    text = gtk_text('Yoda Text - with hover and focus effect (called .hover1)')
+    text = gtk_text(
+      'Yoda Text - with hover and focus effect (called .hover1)'
+    )
     text.css_class('BG_Black')
     text.css_class('yoda')
-    text.css_class('pad8px')
+    text.pad8px
     text.css_class('hover1')
     text.make_selectable
     minimal(text, 3)
 
-    entry = Gtk::Entry.new('This is a test for Gtk::Entry.')
+    entry = gtk_entry('This is a test for Gtk::Entry.')
     entry.set_name('hover1')
     minimal(entry, 2)
     
@@ -239,16 +262,30 @@ class AdvancedCssExample < ::Gtk::Box
     box.css_class('box_shadow1')
     minimal(box, 25)
 
+    box = hbox
+    button_stop = gtk_button('Stop')
+    hbox1 = gtk_hbox
+    hbox1.css_class('background_for_a_fancy_hover_button_effect')
+    hbox1.add(button_stop)
+    hbox1.show_all
+    button_stop.on_clicked {
+      e 'A button was clicked.'
+    }
+    box.add(hbox1)
+    minimal(box, 10)
   end
 
   # ========================================================================= #
   # === run                                                         (run tag)
   # ========================================================================= #
   def run
+    # ======================================================================= #
     # We have to either manually run the method called apply_the_css_string()
     # or we will let Gtk::Runner do this for us when .run() is called.
-    apply_the_css_string # For now this has to be called manually.
-    create_skeleton_then_connect_skeleton
+    # apply_the_css_string # For now this has to be called manually.
+    # ^^^ since as of January 2022 this no longer has to be called manually.
+    # ======================================================================= #
+    super()
   end
 
   # ========================================================================= #

data/lib/gtk_paradise/examples/advanced/014_popup_example.rb

@@ -31,17 +31,17 @@ class PopupExample < ::Gtk::Box
   end
 
   # ========================================================================= #
-  # === foobar_action1
+  # === context_menu_action_number1
   # ========================================================================= #
-  def foobar_action1
-    e 'This is foobar action 1.'
+  def context_menu_action_number1
+    e 'This is context menu action 1.'
   end
 
   # ========================================================================= #
-  # === foobar_action2
+  # === context_menu_action_number2
   # ========================================================================= #
-  def foobar_action2
-    e 'This is foobar action 2.'
+  def context_menu_action_number2
+    e 'This is context menu action 2.'
   end
 
   # ========================================================================= #
@@ -59,8 +59,8 @@ class PopupExample < ::Gtk::Box
     @context_menu = create_context_menu(self) {{
       # n_entries: 12,
       actions: {
-        'FoobarAction1': :foobar_action1,
-        'FoobarAction2': :foobar_action2
+        'FoobarAction1': :context_menu_action_number1,
+        'FoobarAction2': :context_menu_action_number2
       }
     }}
     @context_menu.css_class(
@@ -89,7 +89,7 @@ class PopupExample < ::Gtk::Box
     @button = gtk_button('Right click on me, with the mouse button.')
     @button.disallow_resizing
     @button.set_size_request(300, 300)
-    @button.css_class('bblack2')
+    @button.bblack2
     maximal(@button)
   end
 

data/lib/gtk_paradise/examples/advanced/015_advanced_button_example.rb

@@ -57,19 +57,7 @@ class AdvancedButtonExample < ::Gtk::Box
     # === @configuration
     # ======================================================================= #
     @configuration = [true, __dir__, NAMESPACE]
-    # ======================================================================= #
-    # === @title
-    # ======================================================================= #
-    @title  = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    set_use_this_font(:dejavu_condensed_20)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, :dejavu_condensed_20)
     use_gtk_paradise_project_css_file
     infer_the_size_automatically
     # ======================================================================= #
@@ -86,14 +74,14 @@ class AdvancedButtonExample < ::Gtk::Box
   # === padding?
   # ========================================================================= #
   def padding?
-    0
+    6
   end
 
   # ========================================================================= #
   # === border_size?
   # ========================================================================= #
   def border_size?
-    0
+    2
   end
 
   # ========================================================================= #
@@ -115,11 +103,11 @@ class AdvancedButtonExample < ::Gtk::Box
     button1.css_class('clear_background')
     button1.css_class('BG_lightgreen')
     button1.disallow_resizing
-    button1.prelight_colour :mistyrose # Test the prelight effect.
+    button1.hover_colour :mistyrose # Test the prelight effect.
     hbox = gtk_hbox(button1)
-    hbox.width_height(100, 100)
-    #minimal(button1, 3)
-    pack_start(hbox, fill: false, expand: false, padding: 3)
+    hbox.set_border_width(4)
+    hbox.width_height(120, 120)
+    pack_start(hbox, fill: false, expand: false, padding: 5)
     set_border_width(4)
   end
 

data/lib/gtk_paradise/examples/advanced/017_lean_CSS_example.rb

@@ -67,16 +67,7 @@ class LeanCSSExample < ::Gtk::Box
     # ======================================================================= #
     # === @title
     # ======================================================================= #
-    @title  = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    set_use_this_font(USE_THIS_FONT)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
     use_gtk_paradise_project_css_file
     infer_the_size_automatically
     # ======================================================================= #
@@ -205,15 +196,21 @@ class LeanCSSExample < ::Gtk::Box
 
     entry = gtk_entry('This is a test for Gtk::Entry.')
     entry.set_name('hover1')
-    minimal(entry, 2)
+    entry.yellowish_background
+    entry.bblack1
+    entry.width_height(150, 50)
+    hbox = gtk_vbox
+    hbox.minimal(entry, 5)
+    minimal(hbox, 5)
 
     box = hbox
-    box.add(bold_text('This is just some text.'))
+    box.add(
+      bold_text('This is just some text via box-shadow CSS effects.')
+    )
     box.css_class('slider1')
     minimal(box, 15)
 
     minimal(box, 25)
-
   end
 
   # ========================================================================= #