swing_paradise 0.1.46

data/lib/swing_paradise/java_classes/jscrollpane/jscrollpane.rb

@@ -0,0 +1,84 @@
+# =========================================================================== #
+# require 'swing_paradise/java_classes/jscrollpane/jscrollpane.rb'
+# =========================================================================== #
+class Java::JavaxSwing::JScrollPane
+
+  # ========================================================================= #
+  # === use_this_font=
+  # ========================================================================= #
+  alias use_this_font= setFont
+
+  # ========================================================================= #
+  # === vertical_scrollbar_always
+  # ========================================================================= #
+  def vertical_scrollbar_always
+    setVerticalScrollBarPolicy(
+      JScrollPane::VERTICAL_SCROLLBAR_ALWAYS
+    )
+  end
+
+  # ========================================================================= #
+  # === always_policy
+  # ========================================================================= #
+  def always_policy
+    horizontal_always
+    vertical_always
+  end
+
+  # ========================================================================= #
+  # === horizontal_always
+  # ========================================================================= #  
+  def horizontal_always
+    setHorizontalScrollBarPolicy(JScrollPane::HORIZONTAL_SCROLLBAR_ALWAYS)
+  end
+
+  # ========================================================================= #
+  # === vertical_always
+  # ========================================================================= #
+  def vertical_always
+    setVerticalScrollBarPolicy(JScrollPane::VERTICAL_SCROLLBAR_ALWAYS)
+  end
+
+  # ========================================================================= #
+  # === dimensions
+  #
+  # This is just a wrapper over setBounds() to allow us to work with
+  # a Hash instead.
+  # ========================================================================= #
+  def dimensions(
+      hash = {
+        x_axis:  10,
+        y_axis:  20,
+        width:  300,
+        height:  50
+      }
+    )
+    # is: x-coordinate, y-coordinate, width, height)
+    setBounds(
+      hash[:x_axis],
+      hash[:y_axis],
+      hash[:width],
+      hash[:height]
+    )
+  end
+
+  # ========================================================================= #
+  # === bblack1
+  #
+  # For now this method doesn't do anything; in the future we should
+  # create a black border through this method.
+  # ========================================================================= #
+  def bblack1
+  end
+
+  # ========================================================================= #
+  # === pad5px
+  # ========================================================================= #
+  def pad3px; end
+  def pad4px; end
+  def pad5px; end
+  def pad6px; end
+  def pad7px; end
+  def pad8px; end
+
+end

data/lib/swing_paradise/java_classes/jspinner/jspinner.rb

@@ -0,0 +1,17 @@
+class Java::JavaxSwing::JSpinner
+
+  # ========================================================================= #
+  # === text?
+  # ========================================================================= #
+  def text?
+    getValue.to_s
+  end
+
+  # ========================================================================= #
+  # === background=
+  # ========================================================================= #
+  def background=(i)
+    getEditor.getComponent(0).setBackground(i)
+  end
+
+end

data/lib/swing_paradise/java_classes/jtextarea/jtextarea.rb

@@ -0,0 +1,120 @@
+# =========================================================================== #
+# require 'swing_paradise/java_classes/jtextarea/jtextarea.rb'
+# =========================================================================== #
+java_import javax.swing.border.Border
+java_import javax.swing.BorderFactory
+
+class Java::JavaxSwing::JTextArea
+
+  alias original_set_font set_font # === original_set_font
+
+  # ========================================================================= #
+  # === set_content
+  # ========================================================================= #
+  def set_content(i)
+    set_text(i.to_s)
+  end
+
+  # ========================================================================= #
+  # === use_this_font=
+  # ========================================================================= #
+  def use_this_font=(i)
+    if i.is_a?(String) or i.is_a?(Symbol)
+      i = SwingParadise.jruby_font(i)
+    end
+    setFont(i)
+  end
+
+  # ========================================================================= #
+  # === set_font
+  # ========================================================================= #
+  def set_font(i = :hack_25)
+    original_set_font(
+      SwingParadise.jruby_font(i)
+    )
+  end
+
+  # ========================================================================= #
+  # === on_enter_key_pressed
+  # ========================================================================= #
+  # def on_enter_key_pressed(&block)
+  #   addActionListener(&block)
+  # end
+
+  # ========================================================================= #
+  # === filter_newlines
+  # ========================================================================= #
+  def filter_newlines
+    getDocument.putProperty('filterNewlines', true)
+  end
+
+  # ========================================================================= #
+  # === x_y_width_height
+  # ========================================================================= #
+  def x_y_width_height(
+      x      = 200,
+      y      = 320,
+      width  = 600,
+      height = 350
+    )
+    setBounds(x, y, width, height) # x, y, width, height
+  end
+
+  # ========================================================================= #
+  # === make_border
+  # ========================================================================= #
+  def make_border(
+      use_this_colour     = Color::BLACK,
+      width_of_the_border = 3
+    )
+    setBorder(
+      BorderFactory.createLineBorder(use_this_colour, width_of_the_border)
+    )
+  end
+
+  # ========================================================================= #
+  # === clear
+  # ========================================================================= #
+  def clear
+    set_text('')
+  end
+
+  # ========================================================================= #
+  # === dimensions
+  #
+  # This is just a wrapper over setBounds() to allow us to work with
+  # a Hash instead.
+  # ========================================================================= #
+  def dimensions(
+      hash = {
+        x_axis:  10,
+        y_axis:  20,
+        width:  300,
+        height:  50
+      }
+    )
+    # is: x-coordinate, y-coordinate, width, height)
+    setBounds(
+      hash[:x_axis],
+      hash[:y_axis],
+      hash[:width],
+      hash[:height]
+    )
+  end
+
+  # ========================================================================= #
+  # === text?
+  # ========================================================================= #
+  def text?
+    getText
+  end
+
+  # Currently not implemented.
+  def pad8px
+  end
+
+  def visible_cursor
+    e 'visible_cursor has not yet been implemented.'
+  end
+
+end

data/lib/swing_paradise/java_classes/jtextfield/jtextfield.rb

@@ -0,0 +1,314 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'swing_paradise/java_classes/jtextfield/jtextfield.rb'
+# =========================================================================== #
+# java_import 'javax.swing.text.JTextComponent'
+# =========================================================================== #
+# https://docs.oracle.com/javase/8/docs/api/javax/swing/JTextField.html
+# =========================================================================== #
+class Java::JavaxSwing::JTextField
+
+  alias original_set_font set_font # === original_set_font
+
+  alias select_everything selectAll # === select_everything
+
+  # ========================================================================= #
+  # === on_mouse_click_select_everything
+  #
+  # This method will, upon left-mouse-button press event, select the
+  # whole JTextField.
+  #
+  # The method works, as verified in January 2024.
+  # ========================================================================= #
+  def on_mouse_click_select_everything
+    mouse_listener {|event|
+      if left_mouse_click?(event)
+        requestFocus # ← This may not be necessary, but let's see nonetheless.
+        select_everything # or: select(0, getText.length)
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === set_maxsize
+  #
+  # This is currently not implemented.
+  # ========================================================================= #
+  def set_maxsize(i = 1)
+    # if length > i
+    # end
+  end
+
+  # ========================================================================= #
+  # === signal_connect
+  # ========================================================================= #
+  def signal_connect(i = '', &block)
+    e '.signal_connect() is not yet implemented.'
+  end
+
+  # ========================================================================= #
+  # === on_enter_key_pressed
+  # ========================================================================= #
+  def on_enter_key_pressed(&block)
+    addActionListener(&block)
+  end; alias on_enter_key on_enter_key_pressed # === on_enter_key
+
+  # ========================================================================= #
+  # === do_focus
+  # ========================================================================= #
+  def do_focus
+    requestFocusInWindow()
+  end
+
+  # ========================================================================= #
+  # === the_user_may_not_modify_this_entry
+  #
+  # This method will disallow any user-driven changes to the JTextfield
+  # at hand.
+  # ========================================================================= #
+  def the_user_may_not_modify_this_entry
+    setEditable(false)
+  end; alias disallow_changes the_user_may_not_modify_this_entry # === disallow_changes
+
+  # ========================================================================= #
+  # === use_this_font=
+  # ========================================================================= #
+  def use_this_font=(i)
+    if i.is_a?(String) or i.is_a?(Symbol)
+      i = SwingParadise.jruby_font(i)
+    end
+    setFont(i)
+  end
+
+  # ========================================================================= #
+  # === center
+  # ========================================================================= #
+  def center
+    setHorizontalAlignment(JTextField::CENTER)
+  end; alias align_to_the_center center # === center
+       alias do_center           center # === do_center
+
+  # ========================================================================= #
+  # === on_enter
+  # ========================================================================= #
+  def on_enter(&block)
+    addActionListener {|event|
+      if event.getKeyCode == KeyEvent::VK_ENTER
+        e 'ENTER WAS PRESSED.'
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === hint=
+  # ========================================================================= #
+  def hint=(i = '')
+    setToolTipText(i)
+  end; alias fancy_hint= hint= # === fancy_hint=
+
+  # ========================================================================= #
+  # === shadow_hint=
+  # ========================================================================= #
+  def shadow_hint=(i = '')
+    e 'Todo: implement shadow_hint='
+  end
+
+  # ========================================================================= #
+  # === set_background_colour
+  #
+  # Colours can also be set via:
+  #
+  #   java.awt.Color.new(175, 238, 238)
+  #
+  # ========================================================================= #
+  def set_background_colour(i = ::Color::RED)
+    setBackground(i)
+  end
+
+  # ========================================================================= #
+  # === set_font
+  # ========================================================================= #
+  def set_font(i = :hack_25)
+    original_set_font(
+      SwingParadise.jruby_font(i)
+    )
+  end
+
+  # ========================================================================= #
+  # === dimensions
+  #
+  # This is just a wrapper over setBounds() to allow us to work with
+  # a Hash instead.
+  # ========================================================================= #
+  def dimensions(
+      hash = {
+        x_axis:  10,
+        y_axis:  20,
+        width:  300,
+        height:  50
+      }
+    )
+    # is: x-coordinate, y-coordinate, width, height)
+    setBounds(
+      hash[:x_axis],
+      hash[:y_axis],
+      hash[:width],
+      hash[:height]
+    )
+  end
+
+  # ========================================================================= #
+  # === enable_dragging
+  # ========================================================================= #
+  def enable_dragging
+    setDragEnabled(true)
+  end
+
+  # ========================================================================= #
+  # === text?
+  # ========================================================================= #
+  def text?
+    getText.to_s
+  end
+
+  # ========================================================================= #
+  # === default=
+  # ========================================================================= #
+  def default=(i)
+    setText(i.to_s)
+  end
+
+  alias set_text setText # === set_text
+
+  alias width_height     set_size # === width_height
+  alias set_size_request set_size # === set_size_request
+
+  # ========================================================================= #
+  # === <<
+  # ========================================================================= #
+  def <<(i)
+    setText(i)
+  end
+
+  # ========================================================================= #
+  # === on_enter_pressed
+  # ========================================================================= #
+  def on_enter_pressed(&block)
+    add_action_listener(&block)
+  end
+
+  # ========================================================================= #
+  # Past this points we'll have stubs. These may be improved at a later time,
+  # or never. Either way they have to be defined, at the least.
+  # ========================================================================= #
+
+  # ========================================================================= #
+  # === highlight_on_click_event
+  # ========================================================================= #
+  def highlight_on_click_event
+  end
+
+  # ========================================================================= #
+  # === add_css_class
+  # ========================================================================= #
+  def add_css_class(i = '')
+  end
+
+  # ========================================================================= #
+  # === pad4px
+  # ========================================================================= #
+  def pad4px
+  end
+
+  # ========================================================================= #
+  # === bblack1
+  # ========================================================================= #
+  def bblack1
+  end
+
+  # ========================================================================= #
+  # === bblack2
+  # ========================================================================= #
+  def bblack2
+  end
+  
+  # ========================================================================= #
+  # === bblack3
+  # ========================================================================= #
+  def bblack3
+  end
+  
+  # ========================================================================= #
+  # === bblack4
+  # ========================================================================= #
+  def bblack4
+  end
+
+  # ========================================================================= #
+  # === bblack5
+  # ========================================================================= #
+  def bblack5
+  end
+
+  # ========================================================================= #
+  # === clear_background
+  #
+  # This method currently does not do anything, as it is only necessary
+  # in ruby-gtk3 really.
+  # ========================================================================= #
+  def clear_background
+  end
+
+  # ========================================================================= #
+  # === css_class
+  #
+  # This method currently does not work.
+  # ========================================================================= #
+  def css_class(i = '')
+  end
+
+  # ========================================================================= #
+  # === make_bold
+  # ========================================================================= #
+  def make_bold(
+      font_size = 20
+    )
+    setFont(
+      getFont.deriveFont(Font::BOLD, font_size)
+    )
+  end
+
+  # ========================================================================= #
+  # === on_click_select_all
+  # ========================================================================= #
+  def on_click_select_all(&block)
+    e 'Todo: implement on-click-select-all.'
+  end
+
+  # ========================================================================= #
+  # === on_key_press_event
+  # ========================================================================= #
+  def on_key_press_event(&block)
+    e 'Todo: implement on-key-press-event.'
+  end
+
+  # ========================================================================= #
+  # === very_light_yellow_background
+  # ========================================================================= #
+  def very_light_yellow_background
+    set_background_colour(
+      java.awt.Color.new(99, 99, 83)
+    )
+  end; alias very_light_yellowish_background very_light_yellow_background # === very_light_yellowish_background
+
+  def set_activates_default(i = nil)
+    e 'Todo: implement set_activates_default or ignore it.'
+  end
+
+  def enable_events
+    e 'enable_events has not yet been implemented.'
+  end
+
+end

data/lib/swing_paradise/java_classes/label

@@ -0,0 +1 @@
+jlabel

data/lib/swing_paradise/java_classes/panel

@@ -0,0 +1 @@
+jpanel

data/lib/swing_paradise/java_classes/spinner

@@ -0,0 +1 @@
+jspinner

data/lib/swing_paradise/java_classes/textarea

@@ -0,0 +1 @@
+jtextarea

data/lib/swing_paradise/misc/misc.rb

@@ -0,0 +1,57 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'swing_paradise/misc/misc.rb'
+# =========================================================================== #
+module SwingParadise
+
+  # ========================================================================= #
+  # === SwingParadise.window
+  #
+  # This is ultimately a wrapper over JFrame.
+  # ========================================================================= #
+  def self.window(
+      width  = 640,
+      height = 480
+    )
+    require 'swing_paradise/java_classes/jframe/jframe.rb'
+    widget = Java::JavaxSwing::JFrame.new
+    if width and height
+      widget.width_height(width, height)
+    end
+    return widget
+  end; self.instance_eval { alias create_frame window } # === SwingParadise.create_frame
+
+  # ========================================================================= #
+  # === SwingParadise.frame
+  # ========================================================================= #
+  def self.frame(frame_title = '')
+    JFrame.new(frame_title)
+  end
+
+  # ========================================================================= #
+  # === SwingParadise.jpanel
+  # ========================================================================= #
+  def self.jpanel
+    JPanel.new
+  end; self.instance_eval { alias panel jpanel } # === SwingParadise.panel 
+
+  # ========================================================================= #
+  # === jframe
+  # ========================================================================= #
+  def jframe(frame_title = '')
+    ::SwingParadise.frame(frame_title)
+  end; alias frame jframe # === frame
+
+  # ========================================================================= #
+  # === jtextview
+  #
+  # JTextArea is the one for multi-line input.
+  # ========================================================================= #
+  def jtextview(i = '')
+    JTextArea.new(i)
+  end; alias text_view jtextview # === text_view
+       alias textview  jtextview # === textview
+
+end

data/lib/swing_paradise/prototype/prototype.rb

@@ -0,0 +1,79 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This is the prototype for jruby-swing applications.
+# =========================================================================== #
+include Java
+
+module SwingParadise
+
+class Prototype < javax.swing.JFrame
+
+  require 'swing_paradise'
+  include ::SwingParadise::BaseModule # Scope onto the toplevel here.
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = 1420
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = 820
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    reset
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    reset_the_shared_module if respond_to?(:reset_the_shared_module)
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    frame = frame('Showcasing JEditorPane')
+    panel = new_panel # This is an instance of Java::JavaxSwing::JPanel.
+    panel.set_font(Font.new 'Sans serif', Font::PLAIN, 85)
+    frame.getContentPane.add(panel)
+    panel.box_layout
+
+    panel.hint = 'A quit button example'
+    editor_pane = JEditorPane.new
+    # editor_pane.readonly
+    editor_pane.set_size(820, 600)
+    editor_pane.use_this_font = :hack_32
+    
+    # ======================================================================= #
+    # Put the editor pane in a scroll pane.
+    # ======================================================================= #
+    scroll_pane = scroll_pane(editor_pane)
+    scroll_pane.vertical_scrollbar_always
+    scroll_pane.min_size(820, 700)
+
+    panel << editor_pane
+    panel << quit_button
+    frame.set_font(Font.new 'Sans serif', Font::PLAIN, 85)
+    frame.exit_on_close
+    frame.set_size(WIDTH, HEIGHT)
+    frame.setLocationRelativeTo(nil)
+    frame.show_all
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  SwingParadise::Prototype.new
+end