Message Box Panel 0.1.0

Glimmer DSL for SWT Message Box Panel Custom Shape.

message_box_panel is the Glimmer GUI DSL keyword provided by this gem.

It is a graphical alternative to the native message_box widget, which is fully customizable.

It is used in Glimmer Quarto.

Add the follwing to Gemfile:

gem 'glimmer-cp-messageboxpanel', '~> 0.1.0'

Run bundle install or bundle:

bundle

Run:

gem install glimmer-cp-messageboxpanel

First, add this to your Ruby file:

require 'glimmer-cp-messageboxpanel'

Then, use this keyword:

message_box_panel(options) { properties_and_listeners }

Options (keyword args) are:

• :message
• :location_x (default: :default): :default value means centered horizontally within parent
• :location_y (default: :default): :default value means centered vertically within parent
• :size_width (default: [:default, @font_height*4.0]): default value is text width plus extra width equal to text font height multiplied by 4
• :size_height (default: [:default, @font_height*4.0]): default value is text height plus extra height equal to text font height multiplied by 4
• :background_color (default: :white): background color for text and round rectangle
• :foreground_color (default: :black): foreground color used in border
• :border_line_width (default: 1): border line width
• :text_font (default: {height: 12}): text font, which has height 12 by default
• :text_color (default: :black): text color, which is black by default

The glimmer-cp-messageboxpanel Ruby gem adds to glimmer samples, showing up when you run:

glimmer samples

Glimmer GUI DSL code (from samples/message_box_panel/hello_message_box_panel.rb):

require_relative '../../lib/glimmer-cp-messageboxpanel' # Use `require 'glimmer-cp-messageboxpanel'` if gem is installed

class HelloMessageBoxPanel
  include Glimmer::UI::CustomShell
  
  body {
    shell {
      text 'Hello, Message Box Panel!'
      minimum_size 425, 200
      
      @canvas = canvas {
        background :white

        first_message_box_panel
      }
    }
  }
  
  def first_message_box_panel
    message_box_panel(message: 'Hello, Message Box Panel!', background_color: rgb(255, 255, 128), text_font: {height: 16}) {
      on_closed do
        @canvas.content { # re-open canvas content and add a message box panel
          second_message_box_panel
        }
      end
    }
  end
  
  def second_message_box_panel
    message_box_panel(message: "Message Box Panel is a graphical\nversion of the native Message Box", background_color: :cyan, text_font: {height: 16}, border_line_width: 3) {
      on_closed do
        @canvas.content { # re-open canvas content and add a message box panel
          third_message_box_panel
        }
      end
    }
  end
  
  def third_message_box_panel
    message_box_panel(message: "It is a customizable alternative that can\n be used in Canvas-based applications", background_color: :yellow, foreground_color: :red, text_color: :dark_green, text_font: {height: 16, style: [:bold, :italic]}, border_line_width: 3) {
      on_closed do
        @canvas.content { # re-open canvas content and add a message box panel
          fourth_message_box_panel
        }
      end
    }
  end
  
  def fourth_message_box_panel
    message_box_panel(message: 'Good bye, Message Box Panel!', background_color: :black, text_color: :white, text_font: {height: 16}) {
      on_closed do
        @canvas.content { # re-open canvas content and add a message box panel
          first_message_box_panel
        }
      end
    }
  end
end

HelloMessageBoxPanel.launch

Hello, Message Box Panel!

• Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
• Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
• Fork the project.
• Start a feature/bugfix branch.
• Commit and push until you are happy with your contribution.
• Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
• Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

If you need new features or spot things that need to be fixed or improved, please report in an Issue or submit a Pull Request.

TODO.md

CHANGELOG.md

MIT

Copyright (c) 2022 - Andy Maleh.

--

Built for Glimmer DSL for SWT (JRuby Desktop Development GUI Framework).