gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/base_module/table.rb

@@ -1,438 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# This file contains code that is related to "tables" in gtk. This refers
-# both to the official Gtk::Table binding, but also to custom approaches
-# such as table2() denoting a table with two elements per row.
-# =========================================================================== #
-# require 'gtk_paradise/base_module/table.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  require 'gtk_paradise/toplevel_methods/determine_which_gtk_version_is_in_use.rb'
-
-  # ========================================================================= #
-  # === @default_gtk_adjustment
-  #
-  # This is the default gtk-adjustment to use.
-  # ========================================================================= #
-  @default_gtk_adjustment = 
-    ::Gtk::Adjustment.new(0.0, 0.0, 105.0, 0.2, 1.0, 1.0)
-
-  # ========================================================================= #
-  # === gtk_table2
-  #
-  # This method will create a table with 2 rows per line, based on
-  # ListStore, TreeView and TreeViewColumn.
-  #
-  # As input you should provide an Array with even numbers, e. g.
-  # 2, 4, 6 elements and so forth.
-  #
-  # Note that this method return both the tree-view as well as the
-  # list-store.
-  #
-  # Usage example:
-  #
-  #   use_this_dataset = return_dataset_as_expanded_array
-  #   _ = gtk_table2(use_this_dataset)
-  #
-  # ========================================================================= #
-  def gtk_table2(*i)
-    i.flatten! # Must keep our Array flat.
-    list_store = ::Gtk::ListStore.new(String, String)
-    # ======================================================================= #
-    # === Handle blocks next
-    # ======================================================================= #
-    if block_given?
-      yielded = yield
-      # ===================================================================== #
-      # === :list_store
-      # ===================================================================== #
-      if yielded.is_a?(Hash) and yielded.has_key?(:list_store)
-        list_store = yielded[:list_store]
-      end
-    end
-    tree_view = ::Gtk::TreeView.new(list_store)
-    # ======================================================================= #
-    # Get the first two members and make them the column-headers.
-    # ======================================================================= #
-    column1 = ::Gtk::TreeViewColumn.new(i.shift.to_s, ::Gtk::CellRendererText.new, { text: 0 })
-    column2 = ::Gtk::TreeViewColumn.new(i.shift.to_s, ::Gtk::CellRendererText.new, { text: 1 })
-    # ======================================================================= #
-    # Add the two columns to the tree-view next.
-    # ======================================================================= #
-    tree_view.append_column(column1)
-    tree_view.append_column(column2)
-    # ======================================================================= #
-    # Next we will feed the members of that Array in pairs-of-2 into
-    # the TreeView widget, which explains why we use .each_slice().
-    # ======================================================================= #
-    i.each_slice(2) { |first, second|
-      iter = list_store.append
-      iter.set_value(0, first)
-      iter.set_value(1, second)
-    } unless i.empty?
-    if ::Gtk.use_gtk2?
-      tree_view.enable_model_drag_source(Gdk::Window::BUTTON1_MASK,
-        [ ['GTK_TREE_MODEL_ROW', 0, 0] ], 
-        Gdk::DragContext::ACTION_COPY|Gdk::DragContext::ACTION_MOVE
-      )
-    else # else it is ruby-GTK3
-      tree_view.enable_model_drag_source(:button1_mask,
-        [ ['GTK_TREE_MODEL_ROW', 0, 0] ], 
-        Gdk::DragAction::COPY|Gdk::DragAction::MOVE
-      )
-    end
-    if ::Gtk.use_gtk2?
-      tree_view.enable_model_drag_dest(
-        [ ['GTK_TREE_MODEL_ROW', 0, 0] ],
-        Gdk::DragContext::ACTION_COPY|Gdk::DragContext::ACTION_MOVE
-      )
-    else # else it is ruby-GTK3
-      tree_view.enable_model_drag_dest(
-        [ ['GTK_TREE_MODEL_ROW', 0, 0] ],
-        Gdk::DragAction::COPY|Gdk::DragAction::MOVE
-      )
-    end
-    # ======================================================================= #
-    # Two results will be returned next, via an Array.
-    # ======================================================================= #
-    return [tree_view, list_store] # ← Last but not least, return the tree-view here, together with the list store.
-  end; alias tree_view_table2                     gtk_table2 # === table2
-       alias tree_widget_with_two_columns_per_row gtk_table2 # === tree_widget_with_two_columns_per_row
-
-  # ========================================================================= #
-  # === gtk_table3
-  #
-  # This method will create a table with 3 rows per line, based on
-  # ListStore, TreeView and TreeViewColumn. Otherwise it is identical
-  # to gtk_table2, so please look at the documentation there.
-  # ========================================================================= #
-  def gtk_table3(*i)
-    i.flatten! # Must keep our Array flat.
-    list_store = ::Gtk::ListStore.new(String, String, String)
-    # ======================================================================= #
-    # Designate the cell-renderers in use here.
-    # ======================================================================= #
-    cell_renderer_text1 = ::Gtk::CellRendererText.new
-    cell_renderer_text2 = ::Gtk::CellRendererText.new
-    cell_renderer_text3 = ::Gtk::CellRendererText.new
-    # ======================================================================= #
-    # === Handle blocks next
-    # ======================================================================= #
-    if block_given?
-      yielded = yield
-      # ===================================================================== #
-      # === Handle Hashes next
-      # ===================================================================== #
-      if yielded.is_a?(Hash)
-        # =================================================================== #
-        # === :list_store
-        # =================================================================== #
-        if yielded.has_key?(:list_store)
-          list_store = yielded[:list_store]
-        end
-        # =================================================================== #
-        # === :cell_renderer_text1
-        # =================================================================== #
-        if yielded.has_key? :cell_renderer_text1
-          cell_renderer_text1.send(yielded[:cell_renderer_text1])
-        end
-        # =================================================================== #
-        # === :cell_renderer_text2
-        # =================================================================== #
-        if yielded.has_key? :cell_renderer_text2
-          cell_renderer_text2.send(yielded[:cell_renderer_text2])
-        end
-      end
-    end
-    tree_view  = ::Gtk::TreeView.new(list_store)
-    # ======================================================================= #
-    # Get the first two members and make them the column-headers.
-    # ======================================================================= #
-    column1 = ::Gtk::TreeViewColumn.new(i.shift.to_s, cell_renderer_text1, { text: 0 })
-    column2 = ::Gtk::TreeViewColumn.new(i.shift.to_s, cell_renderer_text2, { text: 1 })
-    column3 = ::Gtk::TreeViewColumn.new(i.shift.to_s, cell_renderer_text3, { text: 2 })
-    # ======================================================================= #
-    # Add the two columns to the tree-view next.
-    # ======================================================================= #
-    tree_view.append_column(column1)
-    tree_view.append_column(column2)
-    tree_view.append_column(column3)
-    # ======================================================================= #
-    # Next we will feed the members of that Array in pairs-of-2 into
-    # the TreeView widget, which explains why we use .each_slice().
-    # ======================================================================= #
-    i.each_slice(3) { |first, second, third|
-      iter = list_store.append
-      iter.set_value(0, first)
-      iter.set_value(1, second)
-      iter.set_value(2, third)
-    } unless i.empty?
-    if ::Gtk.use_gtk2?
-      tree_view.enable_model_drag_source(Gdk::Window::BUTTON1_MASK,
-        [ ['GTK_TREE_MODEL_ROW', 0, 0] ], 
-        Gdk::DragContext::ACTION_COPY|Gdk::DragContext::ACTION_MOVE
-      )
-    else # else it is ruby-GTK3
-      tree_view.enable_model_drag_source(:button1_mask,
-        [ ['GTK_TREE_MODEL_ROW', 0, 0] ], 
-        Gdk::DragAction::COPY|Gdk::DragAction::MOVE
-      )
-    end
-    if ::Gtk.use_gtk2?
-      tree_view.enable_model_drag_dest(
-        [ ['GTK_TREE_MODEL_ROW', 0, 0] ],
-        Gdk::DragContext::ACTION_COPY|Gdk::DragContext::ACTION_MOVE
-      )
-    else # else it is ruby-GTK3
-      tree_view.enable_model_drag_dest(
-        [ ['GTK_TREE_MODEL_ROW', 0, 0] ],
-        Gdk::DragAction::COPY|Gdk::DragAction::MOVE
-      )
-    end
-    # ======================================================================= #
-    # Two results will be returned next, via an Array.
-    # ======================================================================= #
-    return [tree_view, list_store] # ← Last but not least, return the tree-view here, together with the list store.
-  end; alias tree_view_table3                      gtk_table3 # === table3
-       alias tree_widget_with_two_columns_per_row3 gtk_table3 # === tree_widget_with_two_columns_per_row3
-
-  # ========================================================================= #
-  # === Gtk::BaseModule.default_gtk_adjustment?
-  # ========================================================================= #
-  def self.default_gtk_adjustment?
-    @default_gtk_adjustment
-  end
-
-  # ========================================================================= #
-  # === gtk_list_store_table3
-  #
-  # Note that this adds elements in an uniform manner, e. g. Strings
-  # only or Integers only and so forth. For now this is hardcoded
-  # towards Strings.
-  #
-  # This method expects (and assumes) that you pass an Array.
-  #
-  # The first three elements then constitute the "heading" section;
-  # the other parts that follow are the various entries in the
-  # columns.
-  # ========================================================================= #
-  def gtk_list_store_table3(*i)
-    i = i.flatten.compact
-    list_store = ::Gtk::ListStore.new(
-      *[String] * 3
-    )
-    tree_view = gtk_tree_view(list_store)
-    renderer = ::Gtk::CellRendererText.new
-    renderer.editable = true
-    tree_view << [i.shift, renderer, text: 0]
-    tree_view << [i.shift, renderer, text: 1]
-    tree_view << [i.shift, renderer, text: 2]
-    i.each_cons(3) {|entry|
-      iter = list_store.append
-      iter.set_value(0, entry[0])
-      iter.set_value(1, entry[1]) if entry[1]
-      iter.set_value(2, entry[2]) if entry[2]
-    }
-    # ======================================================================= #
-    # Next, we need to style this tree view a little bit.
-    # ======================================================================= #
-    tree_view.hadjustment = ::Gtk::BaseModule.default_gtk_adjustment?
-    tree_view.clickable_headers
-    tree_view.enable_drag_and_drop # Enable drag and drop support of the treeview.
-    # ======================================================================= #
-    # tree_view.signal_connect(:button_press_event) { |widget, event|
-    #   if event.event_type == Gdk::Event::BUTTON2_PRESS and event.button == 1 # event.event_type.name
-    # tree_view.signal_connect(:key_press_event) { |widget, event|
-    #  case Gdk::Keyval.to_name(event.keyval)
-    #  when 'Return','KP_Enter' # enter drücken
-    # tree_view.signal_connect(:button_press_event) { |widget, event|
-    # ======================================================================= #
-    #  if event.event_type == Gdk::Event::BUTTON_PRESS # normaler mouse button
-    return tree_view
-  end
-
-  # ========================================================================= #
-  # === gtk_list_store_table4
-  # ========================================================================= #
-  def gtk_list_store_table4(*i)
-    i = i.flatten.compact
-    list_store = ::Gtk::ListStore.new(
-      *[String] * 4
-    )
-    tree_view = gtk_tree_view(list_store)
-    renderer = ::Gtk::CellRendererText.new
-    renderer.editable = true
-    tree_view << [i.shift, renderer, text: 0]
-    tree_view << [i.shift, renderer, text: 1]
-    tree_view << [i.shift, renderer, text: 2]
-    tree_view << [i.shift, renderer, text: 3]
-    i.each_cons(4) {|entry|
-      iter = list_store.append
-      iter.set_value(0, entry[0])
-      iter.set_value(1, entry[1]) if entry[1]
-      iter.set_value(2, entry[2]) if entry[2]
-      iter.set_value(3, entry[3]) if entry[3]
-    }
-    # ======================================================================= #
-    # Next, we need to style this tree view a little bit.
-    # ======================================================================= #
-    tree_view.hadjustment = ::Gtk::BaseModule.default_gtk_adjustment?
-    tree_view.clickable_headers
-    tree_view.enable_drag_and_drop
-    return tree_view
-  end
-
-  # ========================================================================= #
-  # === table3
-  #
-  # Will return a table with a 3 columns layout.
-  # ========================================================================= #
-  def table3(*all_args)
-    table = ::Gtk::Table.new(all_args.size / 3, 2, true)
-    counter = 0
-    slow_counter = 0
-    for element in all_args
-      # print (counter % 2),' ',(counter % 2)+1,' ',slow_counter,' ',slow_counter+1,"\n"
-      table.attach_defaults( 
-        element,
-        (counter % 3), (counter % 3)+1, 
-        slow_counter,   slow_counter+1
-      )
-      counter += 1
-      slow_counter += 1 if  counter % 3 == 0
-    end
-    return table
-  end
-
-  # ========================================================================= #
-  # === gtk_table
-  #
-  # To use this method, try something like this:
-  #
-  #   gtk_table(2, 1)
-  #   table = gtk_table(2, 1) {{ border_width: 2 }}
-  #
-  # This can often be similar to something like this:
-  #
-  #   ::Gtk::Table.new(2, 1, false)
-  #
-  # ========================================================================= #
-  def gtk_table(
-      n_rows = 2, n_columns = 1, homogeneous = false
-    )
-    gtk_table = ::Gtk::Table.new(n_rows, n_columns, homogeneous)
-    if block_given?
-      yielded = yield
-      if yielded.is_a? Hash
-        # =================================================================== #
-        # === :border_width
-        # =================================================================== #
-        if yielded.has_key? :border_width
-          gtk_table.set_border_width(yielded.delete(:border_width))
-        end
-      end
-    end
-    gtk_table
-  end
-
-  # ========================================================================= #
-  # === table4
-  #
-  # will return a table with a 4 columns layout.
-  # ========================================================================= #
-  def table4(*all_args)
-    n_elements = 4
-    table = ::Gtk::Table.new(
-      all_args.size / n_elements, 2, true
-    )
-    counter = 0
-    slow_counter = 0
-    for element in all_args
-      # print (counter % 2),' ',(counter % 2)+1,' ',slow_counter,' ',slow_counter+1,"\n"
-      table.attach_defaults( 
-        element,
-        (counter % n_elements), (counter % n_elements)+1, 
-        slow_counter,   slow_counter+1
-      )
-      counter += 1
-      slow_counter += 1 if  counter % n_elements == 0
-    end
-    return table
-  end
-
-  # ========================================================================= #
-  # === table2
-  #
-  # Will return a table with a 2 columns layout.
-  # ========================================================================= #
-  def table2(*all_args)
-    table = ::Gtk::Table.new(all_args.size / 2, 2, true)
-    counter = 0
-    slow_counter = 0
-    for element in all_args
-      # print (counter % 2),' ',(counter % 2)+1,' ',slow_counter,' ',slow_counter+1,"\n"
-      table.attach_defaults( 
-        element,
-        (counter % 2), (counter % 2)+1, 
-        slow_counter,   slow_counter+1
-      )
-      counter += 1
-      slow_counter += 1 if  counter % 2 == 0
-    end
-    return table
-  end
-
-  # ========================================================================= #
-  # === html_table2
-  # ========================================================================= #
-  def html_table2(*i)
-    _ = gtk_list_store_table2(*i)
-    maximal(_, 0)
-  end
-
-  # ========================================================================= #
-  # === gtk_list_store_table2
-  #
-  # The input to this should be an Array containing Strings.
-  # ========================================================================= #
-  def gtk_list_store_table2(*i)
-    i = i.flatten.compact
-    list_store = ::Gtk::ListStore.new(
-      *[String] * 2
-    )
-    tree_view = gtk_tree_view(list_store)
-    renderer = ::Gtk::CellRendererText.new
-    renderer.editable = true
-    tree_view << [i.shift, renderer, text: 0]
-    tree_view << [i.shift, renderer, text: 1]
-    i.each_slice(2) {|entry|
-      iter = list_store.append
-      iter.set_value(0, entry[0])
-      iter.set_value(1, entry[1]) if entry[1]
-    }
-    # ======================================================================= #
-    # Next, we need to style this tree view a little bit.
-    # ======================================================================= #
-    tree_view.hadjustment = ::Gtk::BaseModule.default_gtk_adjustment?
-    tree_view.clickable_headers
-    tree_view.enable_drag_and_drop
-    return tree_view
-  end
-
-  # ========================================================================= #
-  # === add_table3
-  #
-  # This variant will also pack the list-store, via .maximal().
-  # ========================================================================= #    
-  def add_table3(*i)
-    _ = gtk_list_store_table3(*i)
-    maximal(_, 0)
-    return _ # And return it here, so that we may want to re-use it again.
-  end
-
-end; end

data/lib/gtk_paradise/base_module/time.rb

@@ -1,35 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/time.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # === dd_mm_yy
-  # ========================================================================= #
-  def dd_mm_yy
-    ::Time.now.strftime('%d.%m.%Y') # => '13.09.2015' # dd.mm.yyyy
-  end
-
-  # ========================================================================= #
-  # === return_current_time
-  #
-  # An optional modifier, as an Integer, can be given, which modifies
-  # the time.
-  # ========================================================================= #
-  def return_current_time
-    Time.now.strftime('%H:%M:%S') # => "22:07:16"
-  end; alias return_current_time_in_hh_mm_ss return_current_time # === return_current_time_in_hh_mm_ss
-
-  # ========================================================================= #
-  # === return_current_time_hh_mm_only
-  # ========================================================================= #
-  def return_current_time_hh_mm_only
-    Time.now.strftime('%H:%M') # => "22:07"
-  end; alias return_current_time_hh_mm return_current_time_hh_mm_only # === return_current_time_hh_mm
-
-end; end

data/lib/gtk_paradise/constants/available_cursors.rb

@@ -1,52 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/constants/available_cursors.rb'
-# =========================================================================== #
-module Gtk
-
-  # ========================================================================= #
-  # === AVAILABLE_CURSORS
-  #
-  # Specify the available gtk-related cursors.
-  # ========================================================================= #
-  AVAILABLE_CURSORS = %w(
-    x
-    arrow
-    boat
-    down
-    up
-    bogosity
-    left
-    right
-    side
-    tee
-    left
-    angle
-    spiral
-    center
-    circle
-    clock
-    mug
-    gobbler
-    gumby
-    hand1
-    hand2
-    heart
-    icon
-    iron
-    default
-    left_side
-    left_tee
-    leftbutton 
-  )
-
-  # ========================================================================= #
-  # === Gtk.available_cursors?
-  # ========================================================================= #
-  def self.available_cursors?
-    AVAILABLE_CURSORS
-  end
-
-end

data/lib/gtk_paradise/constants/fonts.rb

@@ -1,38 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# This file will store constants related to fonts, such as setting a
-# default font-size to use, or a default font-family to use.
-# =========================================================================== #
-# require 'gtk_paradise/constants/fonts.rb'
-# =========================================================================== #
-module Gtk
-
-  # ========================================================================= #
-  # === FONT_SIZE
-  #
-  # Uniform default font-size for the whole GUI part. We pick a fairly
-  # large font size, so to honour elderly people who may have a decreased
-  # vision.
-  # ========================================================================= #
-  FONT_SIZE = '22'
-
-  # ========================================================================= #
-  # === USE_THIS_FONT_FAMILY_FOR_GUI_APPLICATIONS
-  #
-  # Here you can specify a certain default font to use for ruby-gtk
-  # applications.
-  # ========================================================================= #
-  USE_THIS_FONT_FAMILY_FOR_GUI_APPLICATIONS =
-    'Bitstream Vera Serif' # 'DejaVu Sans Mono'
-
-  # ========================================================================= #
-  # === USE_THIS_FONT
-  #
-  # This is the aggregate constant, based on the two constants defined
-  # above.
-  # ========================================================================= #
-  USE_THIS_FONT = "#{USE_THIS_FONT_FAMILY_FOR_GUI_APPLICATIONS} #{FONT_SIZE}"
-
-end

data/lib/gtk_paradise/constants/misc.rb

@@ -1,56 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/constants/misc.rb'
-# Gtk::FILE_PROJECT_CSS
-# =========================================================================== #
-module Gtk
-
-  require 'gtk_paradise/project/project.rb'
-
-  # ========================================================================= #
-  # === ARRAY_CSS_FILES
-  # ========================================================================= #
-  ARRAY_CSS_FILES = 
-  [
-    "#{::Gtk.project_base_directory?}css_files/project.css",
-    "#{::Gtk.project_base_directory?}css_files/colours.css"
-  ]
-
-  # ========================================================================= #
-  # === FILE_ARROW_RIGHT
-  #
-  # This constant refers to an right-arrow image. This can be used if you 
-  # need to present to the user where to "click" or look at. In some ways 
-  # it is a bit like Gtk::Expander, just as an image, and larger.
-  # ========================================================================= #
-  FILE_ARROW_RIGHT =
-    "#{PROJECT_BASE_DIRECTORY}images/misc/ARROW_RIGHT.png"
-
-  # ========================================================================= #
-  # === FILE_PROJECT_CSS
-  # ========================================================================= #
-  FILE_PROJECT_CSS =
-    "#{PROJECT_BASE_DIRECTORY}css_files/project.css"
-
-  # ========================================================================= #
-  # === FILE_TABBLE
-  # ========================================================================= #
-  FILE_TABBLE = 
-    "#{PROJECT_BASE_DIRECTORY}images/misc/tabble.png"
-
-  # ========================================================================= #
-  # === Gtk.user_config_dir
-  #
-  # This method may return a string such as "/root/.config".
-  # ========================================================================= #
-  def self.user_config_dir
-    GLib.user_config_dir
-  end
-
-end
-
-if __FILE__ == $PROGRAM_NAME
-  puts Gtk::FILE_PROJECT_CSS  
-end

data/lib/gtk_paradise/constants/newline.rb

@@ -1,14 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/constants/newline.rb'
-# =========================================================================== #
-module Gtk
-
-  # ========================================================================= #
-  # === N
-  # ========================================================================= #
-  N = "\n"
-
-end