gtk_paradise 0.9.120 → 0.12.25

data/lib/gtk_paradise/examples/gtk3/{010_paned_widget_example.rb → 028_paned_widget_example.rb}

@@ -28,6 +28,7 @@ class PanedWidgetExample < ::Gtk::Box
   # ========================================================================= #
   def initialize
     super(:vertical)
+    reset
     self.border_width = 0
     vbox = ::Gtk::Box.new(:vertical, 0)
     add(vbox)
@@ -42,6 +43,7 @@ class PanedWidgetExample < ::Gtk::Box
     # ======================================================================= #
     hpaned = ::Gtk::Paned.new(:horizontal)
     vpaned.add1(hpaned)
+    vpaned.set_name('padded_pane')
     frame = ::Gtk::Frame.new
     frame.shadow_type = :in
     frame.set_size_request(60, 60)
@@ -49,7 +51,9 @@ class PanedWidgetExample < ::Gtk::Box
     # ======================================================================= #
     # Add a simple button next, into a Gtk::Frame.
     # ======================================================================= #
-    button = ::Gtk::Button.new(label: '_Hi there', use_underline: true)
+    button = ::Gtk::Button.new(
+      label: '_Hi there, I want to be dragged!', use_underline: true
+    )
     frame.add(button)
     frame = ::Gtk::Frame.new
     frame.shadow_type = :in
@@ -73,6 +77,31 @@ class PanedWidgetExample < ::Gtk::Box
     )
   end
 
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    setup_CSS_rules
+  end
+
+  # ========================================================================= #
+  # === setup_CSS_rules
+  # ========================================================================= #
+  def setup_CSS_rules
+    css_provider = Gtk::CssProvider.new
+    _ = '#padded_pane paned separator {
+      background-size:   20px;
+      min-width:         20px;
+      background-color:  royalblue;
+    }'
+    css_provider.load(data: _)
+    ::Gtk::StyleContext.add_provider_for_screen(
+      Gdk::Screen.default,
+      css_provider,
+      ::Gtk::StyleProvider::PRIORITY_APPLICATION
+    )
+  end
+
   # ========================================================================= #
   # === create_pane_options
   #
@@ -180,6 +209,7 @@ if __FILE__ == $PROGRAM_NAME
   window.set_title('PanedWidgets')
   window.add(Gtk::PanedWidgetExample.new)
   window.set_size_request(1000, 500)
+  window.signal_connect(:delete_event) { Gtk.main_quit }
   window.move(0, 0)
   window.show_all
   Gtk.main  

data/lib/gtk_paradise/examples/gtk3/{011_sockets.rb → 029_sockets.rb}

@@ -10,6 +10,7 @@ socket = Gtk::Socket.new
 socket.show
 window = Gtk::Window.new
 window.add(socket)
+window.signal_connect(:delete_event) { Gtk.main_quit }
 window.move(0, 0)
 # The following call is only necessary if one of
 # the ancestors of the socket is not yet visible.

data/lib/gtk_paradise/examples/gtk3/{012_notebook_example.rb → 030_notebook_example.rb}

@@ -8,6 +8,8 @@ require 'gtk3'
 
 alias e puts
 
+@counter = 4
+
 Gtk::Settings.default.gtk_font_name = 'Sans 22'
 
 window = Gtk::Window.new
@@ -25,11 +27,15 @@ window = Gtk::Window.new
 # =========================================================================== #
 def add_a_tab(
     widget_to_add = ::Gtk::Button.new(label: 'A new button'),
-    text_to_use   = 'Tab ###'
+    text_to_use   = 'Tab '+@counter.to_s
   )
+  widget_to_add.signal_connect(:clicked) {
+    e 'I was clicked - '+text_to_use
+  }
   @notebook.append_page(widget_to_add, ::Gtk::Label.new(text_to_use))
   @notebook.set_tab_reorderable(widget_to_add, true)
   @notebook.show_all
+  @counter += 1
 end
 
 button_add_a_tab = Gtk::Button.new(label: 'Add a tab')
@@ -64,12 +70,14 @@ test_button = Gtk::Button.new(label: 'Test')
   pp @notebook.page
   true
 }
+# pp @notebook.methods.sort # For debugging purposes.
 
 vbox = Gtk::Box.new(:vertical)
-vbox.add(button_add_a_tab)
-vbox.add(@notebook)
+vbox.pack_start(button_add_a_tab, expand: true, fill: false)
+vbox.pack_start(@notebook, expand: true, fill: true)
 window.add(vbox)
 window.show_all
 window.move(0, 0)
-window.set_size_request(800, 500)
+window.set_size_request(1000, 800)
+window.signal_connect(:delete_event) { Gtk.main_quit }
 Gtk.main

data/lib/gtk_paradise/examples/gtk3/{013_icon_theme_example.rb → 031_icon_theme_example.rb}

@@ -75,6 +75,11 @@ class IconThemeExample < ::Gtk::Box
     image9 = new_pixbuf_image(icon9)
     pack_start(image9, padding: 2)
 
+    use_this_icon_name = 'open-menu-symbolic'
+    icon10 = icon_theme.load_icon(use_this_icon_name, DEFAULT_ICON_SIZE*2, 0)
+    image10 = new_pixbuf_image(icon10)
+    pack_start(image10, padding: 2)
+
     reset
   end
 
@@ -100,5 +105,6 @@ if __FILE__ == $PROGRAM_NAME
   window.show_all
   window.set_size_request(600, -1)
   window.move(0, 0)
+  window.signal_connect(:delete_event) { Gtk.main_quit }
   Gtk.main  
 end

data/lib/gtk_paradise/examples/gtk3/{014_switcher_window.rb → 032_switcher_window.rb}

@@ -26,8 +26,22 @@ class SwitcherWindow < ::Gtk::Box
   # ========================================================================= #
   def initialize
     super(:horizontal)
-    set_border_width(15)
+    set_border_width(16)
+    run
+  end
+
+  # ========================================================================= #
+  # === on_switch_activated
+  # ========================================================================= #
+  def on_switch_activated(switch)
+    state = switch.active? ? 'on' : 'off'
+    e "Switch was turned #{state}"
+  end
 
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
     grid = ::Gtk::Grid.new
     grid.set_column_spacing(6)
     grid.set_row_spacing 6
@@ -45,14 +59,6 @@ class SwitcherWindow < ::Gtk::Box
     }
   end
 
-  # ========================================================================= #
-  # === on_switch_activated
-  # ========================================================================= #
-  def on_switch_activated(switch)
-    state = switch.active? ? 'on' : 'off'
-    e "Switch was turned #{state}"
-  end
-
 end; end
 
 if __FILE__ == $PROGRAM_NAME
@@ -61,7 +67,7 @@ if __FILE__ == $PROGRAM_NAME
   window.set_title(Gtk::SwitcherWindow::TITLE)
   window.add(switcher_window)
   window.signal_connect(:destroy) { Gtk.main_quit }
-  window.set_size_request(300, 100)
+  window.set_size_request(250, 100)
   window.show_all
   window.move(0, 0)
   Gtk.main  

data/lib/gtk_paradise/examples/gtk3/{016_hello_world_in_gtk3_and_bold_font.rb → 034_hello_world_in_gtk3_and_bold_font.rb}

@@ -21,7 +21,7 @@ class HelloWorld < ::Gtk::Box
       run_already = true
     )
     super(:horizontal)
-    set_size_request(400, 400)
+    set_size_request(300, 100)
     set_border_width(10)
     # set_icon_from_file('/Depot/j/foo.png') # <- You could specify a fav-icon too.
     run if run_already

data/lib/gtk_paradise/examples/gtk3/{017_grid_example.rb → 035_grid_example.rb}

@@ -12,7 +12,11 @@ app.signal_connect(:activate) { |application|
   window.set_title('Window')
   window.set_border_width(10)
 
-  # Here we construct the container that is going pack our buttons 
+  # ========================================================================= #
+  # === the grid
+  #
+  # Here we construct the container that is going pack our buttons
+  # ========================================================================= # 
   grid = Gtk::Grid.new
 
   # Pack the container in the window

data/lib/gtk_paradise/examples/gtk3/{018_buttons_showcasing_the_relief.rb → 036_buttons_showcasing_the_relief.rb}

@@ -56,5 +56,6 @@ if __FILE__ == $PROGRAM_NAME
   window.show_all
   window.move(0, 0)
   window.set_size_request(800, 200)
+  window.signal_connect(:delete_event) { Gtk.main_quit }
   Gtk.main  
 end

data/lib/gtk_paradise/examples/gtk3/{019_text_buffer_example.rb → 037_text_buffer_example.rb}

@@ -112,7 +112,9 @@ EOF
       "is just added (appended, actually).\n")
     iter = return_current_iter
     darkblue = @text_buffer.create_tag(nil, { foreground: 'darkblue' })
-    @text_buffer.insert(iter, 'A hyperlink: ', tags: [darkblue] )
+    @text_buffer.insert(
+      iter, 'A hyperlink: <a href="blog.fefe.de">here</a>', tags: [darkblue]
+    )
 
     @scrolled_window.add(@text_view)
   end
@@ -131,15 +133,6 @@ EOF
     @grid = ::Gtk::Grid.new
   end
 
-  # ========================================================================= #
-  # === create_skeleton
-  # ========================================================================= #
-  def create_skeleton
-    create_grid
-    create_scrolled_window
-    create_textview
-  end
-
   # ========================================================================= #
   # === connect_skeleton
   # ========================================================================= #
@@ -196,6 +189,15 @@ EOF
     }
   end
 
+  # ========================================================================= #
+  # === create_skeleton
+  # ========================================================================= #
+  def create_skeleton
+    create_grid
+    create_scrolled_window
+    create_textview
+  end
+
   # ========================================================================= #
   # === run
   # ========================================================================= #

data/lib/gtk_paradise/examples/gtk3/{020_radio_button_window.rb → 038_radio_button_window.rb}

@@ -47,15 +47,6 @@ class RadioButtonWindow < Gtk::Box # === Gtk::RadioButtonWindow
     set_border_width(15)
   end
 
-  # ========================================================================= #
-  # === connect_skeleton
-  # ========================================================================= #
-  def connect_skeleton
-    pack_start(@button1)
-    pack_start(@button2)
-    pack_start(@button3)
-  end
-
   # ========================================================================= #
   # === on_button_toggled
   # ========================================================================= #
@@ -79,6 +70,15 @@ class RadioButtonWindow < Gtk::Box # === Gtk::RadioButtonWindow
     @button3.signal_connect(:toggled) { |b| on_button_toggled(b, 3) }
   end
 
+  # ========================================================================= #
+  # === connect_skeleton
+  # ========================================================================= #
+  def connect_skeleton
+    pack_start(@button1)
+    pack_start(@button2)
+    pack_start(@button3)
+  end
+
   # ========================================================================= #
   # === run
   # ========================================================================= #

data/lib/gtk_paradise/examples/gtk3/{022_popup_example.rb → 040_popup_example.rb}

@@ -5,13 +5,13 @@
 # This is a popup example, that is, when you click the right mouse button,
 # a context-menu will emerge.
 # =========================================================================== #
-# $GTK_PARADISE/examples/gtk3/popup_example.rb
+# $GTK_PARADISE/examples/gtk3/022_popup_example.rb
 # =========================================================================== #
 require 'gtk3'
 
 module Gtk
 
-class PopupExample < ::Gtk::Box # === ::::PopupExample
+class PopupExample < ::Gtk::Box # === Gtk::PopupExample
 
   # ========================================================================= #
   # === initialize

data/lib/gtk_paradise/examples/gtk3/{023_horizontal_and_vertical_scale.rb → 041_horizontal_and_vertical_scale.rb}

@@ -2,7 +2,7 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# $GTK_PARADISE/examples/gtk3/horizontal_and_vertical_scale.rb
+# $GTK_PARADISE/examples/gtk3/023_horizontal_and_vertical_scale.rb
 # =========================================================================== #
 require 'gtk3'
 

data/lib/gtk_paradise/examples/gtk3/{026_hover_button_example_via_css.rb → 043_hover_button_example_via_css.rb}

@@ -42,7 +42,9 @@ EOF
     enable_CSS_support
     set_border_width(25)
     button = ::Gtk::Button.new(
-      label: "Test hover action and transition -\nplace the mouse cursor over this text.\nThis functionality is implemented via button:hover, and transition:"
+      label: "Test hover action and transition -\n"\
+             "place the mouse cursor over this text.\n"\
+             "This functionality is implemented via button:hover, and transition:"
     )
     button.set_name('bblack1')
     button.signal_connect(:clicked) { e 'Click me!' }

data/lib/gtk_paradise/examples/gtk3/{027_spin_button_example.rb → 044_spin_button_example.rb}

@@ -51,9 +51,9 @@ class SpinButtonExample < ::Gtk::Box # === Gtk::SpinButtonExample
 
     hbox = ::Gtk::Box.new(:horizontal)
     vbox.pack_start(hbox, expand: false, fill: true, padding: 5)
-    button5 = ::Gtk::Button.new(label: 'Close')
-    button5.signal_connect(:clicked) { destroy }
-    hbox.pack_start(button5, expand: true, fill: true, padding: 5)
+    button = ::Gtk::Button.new(label: 'Close')
+    button.signal_connect(:clicked) { destroy } # Destroy the widget.
+    hbox.pack_start(button, expand: true, fill: true, padding: 5)
   end
 
   # ========================================================================= #
@@ -77,6 +77,7 @@ if __FILE__ == $PROGRAM_NAME
   hbox = Gtk::Box.new(:horizontal)
   hbox.add(Gtk::SpinButtonExample.new)
   window.add(hbox)
+  window.signal_connect(:delete_event) { Gtk.main_quit }
   window.show_all
   Gtk.main  
 end

data/lib/gtk_paradise/examples/gtk3/{028_radio_menu_item_example.rb → 045_radio_menu_item_example.rb}

@@ -36,7 +36,10 @@ class RadioMenuItemShowcase < ::Gtk::Box # === Gtk::RadioMenuItemShowcase
     # ======================================================================= #
     # Create our toplevel menuitem next:
     # ======================================================================= #
-    top_menu = Gtk::MenuItem.new(label: 'The Root Menu', use_underline: false)
+    top_menu = Gtk::MenuItem.new(
+      label: 'The Root Menu (click on it)',
+      use_underline: false
+    )
     # ======================================================================= #
     # Append the top_menu into the menubar:
     # ======================================================================= #

data/lib/gtk_paradise/examples/gtk3/{029_gtk_dialog_sample.rb → 046_gtk_dialog_sample.rb}

@@ -45,9 +45,12 @@ class DialogSample < ::Gtk::Dialog
         e 'OK'
       when :cancel
         e 'Cancel'
+      # ===================================================================== #
+      # === :close
+      # ===================================================================== #
       when :close, -7
         e 'Close'
-        destroy #dialog.destroy
+        destroy
         Gtk.main_quit
       end
     }

data/lib/gtk_paradise/examples/gtk3/{030_draw_rectangles.rb → 047_draw_rectangles.rb}

@@ -19,7 +19,7 @@ vbox = Gtk::Box.new(:vertical)
   )
   cairo_context.set_source_rgb(0.5, 0.9, 0.6)
   cairo_context.fill
-  for i in (1..11)
+  for i in (1..11) # Here we will modify the colour in use.
     cairo_context.set_source_rgba(0, 0, 1, i*0.1)
     cairo_context.rectangle(50*i, 50, 80, 80)
     cairo_context.fill

data/lib/gtk_paradise/examples/gtk3/{031_colour_choose_button.rb → 048_colour_choose_button.rb}

@@ -14,24 +14,38 @@ require 'gtk3'
 window = Gtk::Window.new
 window.set_size_request(600, 200)
 
+# =========================================================================== #
+# === @entry_this_colour_is_in_use
+# =========================================================================== #
+@entry_this_colour_is_in_use = Gtk::Entry.new
+
+@this_colour_is_in_use = nil
 # =========================================================================== #
 # Add the choose-colour button next.
 # =========================================================================== #
 button = Gtk::ColorButton.new
 button.set_title('Select a Colour!')
 button.signal_connect(:color_set) {
-  puts button.color.to_s
+  @this_colour_is_in_use = button.color.to_s
+  puts @this_colour_is_in_use
+  @entry_this_colour_is_in_use.set_text(@this_colour_is_in_use)
 }
+
 button.color = '#616135358383' # Use a starting-colour.
 button.set_size_request(500, 220)
 
-label = Gtk::Label.new("← Look at the colour. \\o/")
+label = Gtk::Label.new(
+  "← Look then click at the colour box to the left. \\o/"
+)
 
 hbox = Gtk::Box.new(:horizontal, 0)
 hbox.pack_start(button, expand: false, fill: false, padding: 15)
 hbox.pack_start(label,  expand: false, fill: false, padding: 15)
 
-window.add(hbox)
+outer_vbox = Gtk::Box.new(:vertical, 0)
+outer_vbox.add(hbox)
+outer_vbox.add(@entry_this_colour_is_in_use)
+window.add(outer_vbox)
 window.show_all
 window.signal_connect(:destroy) { Gtk.main_quit }
 window.move(0, 0)

data/lib/gtk_paradise/examples/gtk3/{032_drag_and_drop_example.rb → 049_drag_and_drop_example.rb}

@@ -7,12 +7,15 @@ class SrcWindow < Gtk::Window
   # ========================================================================= #
   def initialize
     super('Source Window')
-    @label = Gtk::Label.new('Drag here!')
+    @label = Gtk::Label.new('Start the drag action here!')
     add(@label)
     set_default_size(125, 125)
+    # ======================================================================= #
+    # Set the drag-source:
+    # ======================================================================= #
     drag_source_set(Gdk::ModifierType::BUTTON1_MASK |
                     Gdk::ModifierType::BUTTON2_MASK,
-                    [["test", Gtk::TargetFlags::SAME_APP, 12345]],
+                    [['test', Gtk::TargetFlags::SAME_APP, 12345]],
                     Gdk::DragAction::COPY |
                     Gdk::DragAction::MOVE)
     signal_connect('drag-data-get') { |widget, context, selection_data, info, time|
@@ -30,7 +33,7 @@ class SrcWindow < Gtk::Window
 
 end
 
-class DestWindow < Gtk::Window
+class DropWindow < Gtk::Window
 
   alias e puts
 
@@ -42,7 +45,7 @@ class DestWindow < Gtk::Window
 
     @label = Gtk::Label.new('Drop here!')
     add(@label)
-    set_default_size(125, 125)
+    set_default_size(250, 250)
     drag_dest_set(Gtk::DestDefaults::MOTION |
                   Gtk::DestDefaults::HIGHLIGHT,
                   [['test', :same_app, 12345]],
@@ -61,20 +64,25 @@ class DestWindow < Gtk::Window
         end
       }
     }
+    # This is the drop-event.
     signal_connect(:drag_drop) { |widget, context, x, y, time|
       widget.drag_get_data(context, context.targets[0], time)
     }
     run
   end
+
+  # ========================================================================= #
   # === run
+  # ========================================================================= #
   def run
     move(125, 125)
   end
+
 end
 
 win1 = SrcWindow.new
 win1.move(0, 0)
-win2 = DestWindow.new
+win2 = DropWindow.new
 win2.move(135, 0)
 
 win1.show_all.signal_connect(:destroy) { Gtk.main_quit }

data/lib/gtk_paradise/examples/gtk3/{033_cell_renderer_pixbuf_example.rb → 050_cell_renderer_pixbuf_example.rb}

@@ -11,9 +11,17 @@ class CellRendererPixbufWindow < Gtk::Window
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
-  def initialize
+  def initialize(
+      run_already = true
+    )
     super('CellRendererPixbuf Example')
+    run if run_already
+  end
 
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
     set_default_size(200, 200)
     @liststore = Gtk::ListStore.new(String, String)
     iter = @liststore.append
@@ -41,8 +49,11 @@ class CellRendererPixbufWindow < Gtk::Window
 
 end
 
-win = CellRendererPixbufWindow.new
-win.signal_connect(:destroy) { Gtk.main_quit }
-win.show_all
-win.move(0, 0)
-Gtk.main
+if __FILE__ == $PROGRAM_NAME
+  win = CellRendererPixbufWindow.new
+  win.signal_connect(:destroy) { Gtk.main_quit }
+  win.show_all
+  win.move(0, 0)
+  win.set_border_width(8)
+  Gtk.main  
+end

data/lib/gtk_paradise/examples/gtk3/051_combo_box_example.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# $GTK_PARADISE/examples/gtk3/combo_box_example.rb
+# =========================================================================== #
+require 'gtk3'
+
+alias e puts
+
+window = Gtk::Window.new
+
+combo_box1 = Gtk::ComboBoxText.new
+
+# =========================================================================== #
+# === FROZEN_STRING_CONSTANT
+#
+# Should be frozen.
+# =========================================================================== #
+FROZEN_STRING_CONSTANT = 'ABC'
+
+# =========================================================================== #
+# === ARRAY_FOR_COMBO_BOX1
+# =========================================================================== #
+ARRAY_FOR_COMBO_BOX1 = %w(
+  combo_box_entry1
+  combo_box_entry2
+  combo_box_entry3
+  combo_box_entry4
+  combo_box_entry5
+  combo_box_entry6
+  combo_box_entry7
+  combo_box_entry8
+)
+
+# =========================================================================== #
+# 3000 additions to a combo box cause a delay already. We can toggle that
+# number to lower or higher values, and see whether this makes any
+# difference.
+# =========================================================================== #
+N_TIMES = 250 # 2_500
+N_TIMES.times {
+  ARRAY_FOR_COMBO_BOX1 << FROZEN_STRING_CONSTANT
+}
+
+# =========================================================================== #
+# Add to combo_box1:
+# =========================================================================== #
+ARRAY_FOR_COMBO_BOX1.each { |val| 
+  combo_box1.append_text(val) 
+}
+combo_box1.active = 3
+vbox = Gtk::Box.new(:vertical)
+vbox.add(Gtk::Label.new('Showing '+N_TIMES.to_s+' entries next'))
+vbox.add(combo_box1)
+
+@combo_box2 = Gtk::ComboBoxText.new
+@combo_box2.wrap_width = 5 # This means to pad 5 entries per row.
+%w( one two three four five six ).each { |val| 
+  @combo_box2.append_text(val) 
+}
+@combo_box2.active = 4 # This selects the entry "five".
+@combo_box2.signal_connect(:changed) {
+  if @combo_box2.active_iter
+    e "#{@combo_box2.active}: #{@combo_box2.active_iter[0]}"
+  end
+}
+@proc_for_combo_box2 = proc {
+  @combo_box2.active_text
+}
+# =========================================================================== #
+# === return_the_current_text_of_combo_box_2
+# =========================================================================== #
+def return_the_current_text_of_combo_box_2(i = @proc_for_combo_box2)
+  return i.call
+end
+@combo_box2.set_tooltip_markup(return_the_current_text_of_combo_box_2)
+vbox.add(@combo_box2)
+
+window.add(vbox)
+window.show_all
+window.move(0, 0)
+window.set_size_request(800, 800)
+Gtk.main

data/lib/gtk_paradise/examples/gtk3/{035_notebook_css_example.rb → 052_notebook_css_example.rb}

@@ -101,8 +101,9 @@ application.signal_connect(:activate) {
 
   fixed = Gtk::Fixed.new
   label = Gtk::Label.new(
-      'This script shows how to style a '\
-      'Gtk::Notebook instance via CSS.')
+    'This script shows how to style a '\
+    'Gtk::Notebook instance via CSS.'
+  )
   label.set_name('label1')
   fixed.put(
     label,