gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/examples/gtk3/023_sorted_tree.rb

@@ -0,0 +1,166 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# A brief demonstration of:
+#
+#   - Gtk::Window
+#   - Gtk::ScrolledWindow
+#   - Gtk::ListStore
+#   - Gtk::TreeView
+#   - Gtk::TreeModelSort
+#   - Gtk::TreeModelFilter
+#   - Gtk::CellRenderText
+#   - Gtk::TreeViewcolumn
+#   - Gtk::TreeIter
+#
+# =========================================================================== #
+# require 'sorted_tree.rb'
+# =========================================================================== #
+# $GTK_PARADISE/examples/gtk3/sorted_tree.rb
+# =========================================================================== #
+require 'gtk3'
+
+class SortedTree
+
+  alias e puts
+
+  # =========================================================================== #
+  # === register_sigint
+  # =========================================================================== #
+  def register_sigint
+    Signal.trap('SIGINT') { exit }
+  end
+
+  # =========================================================================== #
+  # === initialize
+  # =========================================================================== #
+  def initialize
+    register_sigint
+    # ======================================================================= #
+    # Create a list store with:
+    #  - an Integer (ID)
+    #  - a String (date)
+    #  - a TrueClass (represents whether or not the row should be shown or 
+    #   not)
+    # ======================================================================= #
+    list_store = Gtk::ListStore.new(Integer, String, TrueClass)
+    # ======================================================================= #
+    # Create a filtered list store that wraps the list store
+    # and set the filter column criteria
+    # ======================================================================= #
+    list_store_filter = Gtk::TreeModelFilter.new(list_store)
+    list_store_filter.visible_column = 2
+    # ======================================================================= #
+    # === Gtk::TreeModelSort
+    #
+    # Create a sorted list store and set the sorting function for the
+    # first column.  Note that we are wrapping the sorted model around
+    # filtered model -- which in turn wraps the original list store model.
+    # ======================================================================= #
+    list_store_sort = Gtk::TreeModelSort.new(list_store_filter)
+    list_store_sort.set_sort_func(0) { |a, b| a[0] <=> b[0] }
+    # ======================================================================= #
+    # Fill the list store with stuff - 3 elements per iter.
+    # ======================================================================= #
+    10.times { |i|
+      iter = list_store.append
+      iter[0] = i
+      iter[1] = Time.now.to_s
+      iter[2] = true
+    }
+    # ======================================================================= #
+    # Create a window with a size of 800x400 pixels next.
+    # ======================================================================= #
+    window = Gtk::Window.new
+    window.set_size_request(800, 400)
+    window.signal_connect(:destroy) { Gtk::main_quit }
+    # ======================================================================= #
+    # Create a treeview, giving it the sorted list store (which is
+    # wrapping the
+    # ======================================================================= #
+    tree_view = Gtk::TreeView.new(list_store_sort)
+    # ======================================================================= #
+    # Create a scrollable window, with automatic scrollbars, and
+    # pack it into the window
+    # ======================================================================= #
+    scrolled_window = Gtk::ScrolledWindow.new
+    scrolled_window.set_policy(:automatic, :automatic)
+    outer_vbox = Gtk::Box.new(:vertical)
+    outer_vbox.add(scrolled_window)
+    button_trigger_event = Gtk::Button.new(label: 'Trigger sorting-event')
+    button_trigger_event.signal_connect(:clicked) {
+      # tree_view.signal_emit(:button_press_event)
+      e 'Currently not working - we want to emit a button-press event.'
+    }
+    outer_vbox.add(button_trigger_event)
+    window << outer_vbox
+    tree_view.signal_connect(:event) {|widget, event|
+      case event.to_s
+      when /Button/
+        e 'The event-button was clicked.'
+      end
+    }
+    scrolled_window.add_with_viewport(tree_view)
+    # ======================================================================= #
+    # Create a CellRenderer that's in charge of rendering the ID. Also
+    # colourize it a little bit.
+    # ======================================================================= # 
+    renderer = Gtk::CellRendererText.new
+    renderer.set_property('background', 'lavender')
+    renderer.set_property('foreground', 'black')
+    # ======================================================================= #
+    # Create the ID column which uses the cell renderer defined above and
+    # is hooked up to the first column of the model. Sorting is turned on
+    # on this column (which also uses the first column in the model
+    # to figure out what to sort)
+    # ======================================================================= #
+    id_column = Gtk::TreeViewColumn.new('ID', renderer, text: 0)
+    id_column.sort_column_id = 0
+    id_column.alignment = 0.5 # Center it.
+    id_column.set_resizable(true)
+    tree_view.append_column(id_column)
+    # ======================================================================= #
+    # Create a column that renders the current time (the second column
+    # in the model.
+    # ======================================================================= #
+    time_column = Gtk::TreeViewColumn.new('Current Time', renderer, text: 1)
+    tree_view.append_column(time_column)
+    tree_view.signal_connect(:button_release_event) { |widget,event|
+      e "The id is: #{widget.selection.selected[0]}"
+    }
+    tree_view.rules_hint = true
+    tree_view.headers_clickable = true
+    tree_view.columns.each_with_index {|content, index|
+      content.set_sort_column_id(index)
+    }
+    tree_view.columns.each {|this_column|
+      this_column.set_resizable(true)
+    }
+    # ======================================================================= #
+    # Show everything
+    # ======================================================================= #
+    window.show_all
+    window.move(0, 0)
+    # ======================================================================= #
+    # Every once in 10 seconds will we loop through each row in the list
+    # and update the time and set half of the rows' visibility attribute 
+    # to false and the other half to true.
+    # ======================================================================= #
+    GLib::Timeout.add(10_000) {
+      list_store.each { |model, path, iter|
+        iter[1] = Time.now.to_s
+        iter[2] = rand(2) == 1
+      }
+    }
+    # ======================================================================= #
+    # Start the Gtk main loop next:
+    # ======================================================================= #
+    Gtk.main
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  SortedTree.new  
+end

data/lib/gtk_paradise/examples/gtk3/{004_small_paned_example.rb → 024_small_paned_example.rb}

@@ -26,8 +26,8 @@ class SmallPanedExample < ::Gtk::Paned # === Gtk::SmallPanedExample
   # === run
   # ========================================================================= #
   def run
-    button1 = ::Gtk::Button.new(label: 'Resize')
-    button2 = ::Gtk::Button.new(label: 'Me!')
+    button1 = ::Gtk::Button.new(label: 'Resize →')
+    button2 = ::Gtk::Button.new(label: '← here')
     button1.signal_connect(:clicked) { puts 'button1 was clicked' }
     button2.signal_connect(:clicked) { puts 'button2 was clicked' }
     pack1(button1)
@@ -40,8 +40,9 @@ end; end
 if __FILE__ == $PROGRAM_NAME
   window = Gtk::Window.new
   paned = ::Gtk::SmallPanedExample.new
+  paned.set_border_width(25)
   window.add(paned)
-  window.set_size_request(225, 150)
+  window.set_size_request(255, 150)
   window.show_all
   window.move(0, 0)
   Gtk.main

data/lib/gtk_paradise/examples/gtk3/{007_progress_bar_example.rb → 026_progress_bar_example.rb}

@@ -55,7 +55,6 @@ progressbar > trough {
   background-color: #101415;
 }
 
-
 '
 
   # ========================================================================= #
@@ -64,7 +63,6 @@ progressbar > trough {
   def initialize
     super(:vertical)
     set_title(TITLE) if respond_to?(:set_title)
-    set_border_width(15)
     set_size_request(800, 350)
 
     # ======================================================================= #
@@ -184,6 +182,7 @@ progressbar > trough {
   # === run
   # ========================================================================= #
   def run
+    set_border_width(15)
     show_all
   end
 

data/lib/gtk_paradise/examples/gtk3/{008_menubar_example.rb → 027_menubar_example.rb}

@@ -28,7 +28,7 @@ class MenubarExample < Gtk::Window
   # ========================================================================= #
   def reset
     set_title 'Simple menubar'
-    Gtk::Settings.default.gtk_font_name = 'DejaVu Sans Mono 19'
+    Gtk::Settings.default.gtk_font_name = 'DejaVu Sans Mono 20'
   end
 
   # ========================================================================= #

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

@@ -180,6 +180,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}

@@ -72,4 +72,5 @@ window.add(vbox)
 window.show_all
 window.move(0, 0)
 window.set_size_request(800, 500)
+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/{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