Message Box Panel 0.1.0

Glimmer Custom Shape

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.

Screenshot

Actual Use

It is used in Glimmer Quarto.

Setup

Bundler

Add the follwing to Gemfile:

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

Run bundle install or bundle:

bundle

Direct

Run:

gem install glimmer-cp-messageboxpanel

API

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

Sample

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

glimmer samples

Hello, Message Box Panel!

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!

Contributing

• 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.

TODO

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

Change Log

CHANGELOG.md

License

MIT

Copyright (c) 2022 - Andy Maleh.

--

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