glimmer-dsl-tk 0.0.28 → 0.0.29

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2da9cdf30a1b710a0122d360320ffe0300a1a325eba5cf35f4749005673b2f9d
-  data.tar.gz: c58af78a953f2feb85dd639595e3a47ea69bcba2097f155124e3597c48080d88
+  metadata.gz: c1fcdcc1d27b712822692998523397ade9998b767e861b47f71cb09305d0590a
+  data.tar.gz: 7810abe93ea87970f241b1401e50c93303a571f753e4ef107753fabd40f5ebbf
 SHA512:
-  metadata.gz: 7e3faf577f5abc1ca7b9e0597fc5e36f7b917c5afc3dbcc0bee99d8168ab5b30a5f571d73a495f7ca86c2e574e4c6e6272d0b83853081020d1ebce9c2b3d6f9c
-  data.tar.gz: 741c9d95b80cff4c7666d78ce7ad0600e9227d5808982e5ea8a5728c39ad0e717148746febc5c57ba7c3d3896e4815ef096d7d41e3b6c52e46f566f5c0053353
+  metadata.gz: d622997fa2f4913ddda14fdab69fd26f40f97f83d7f8646be5a46c874dca53bbdaa73a7e884069a778ebfa2e6dadca3c1e5b61809a79a6b1cdd11236eac5272d
+  data.tar.gz: 97133b4cb58fce828ffa8f6d0c9b361c4681e19bffe4e752c1983e110150ac0d8dac6b464b622f649df68b987e1d3e469f1a7caf2defad2c402e1f405f78f8c4

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Change Log
 
+## 0.0.29
+
+- Hello, Built-in Dialog! (demonstrating all built-in dialogs like get_open_file and choose_color)
+- Hello, Separator!
+- Improve Hello, Text! (toolbar buttons: insert image)
+- Removed unnecessary `text` widget `text` attribute after realizing `value` does the same thing
+- Support `text` widget data-binding on 'modified' event and use in Hello, Text!
+- Support `text#insert_image(text_index, *image_args)`
+- Support `text#get_open_file_to_insert_image(text_index = 'insert')` shortcut for doing both `get_open_file` and `insert_image` in one shot
+- Support built-in dialogs: `get_open_file(options = nil)`, `get_multiple_open_file(options = nil)`, `get_save_file(options = nil)`, `get_multiple_save_file(options = nil)`, `choose_directory(options = nil)`, `choose_color(options = nil)`, `choose_font(initial_font_args) {|font| do_something_with_font(font) }`
+- Support built-in dialog aliases: `open_file`, `multiple_open_file`, `save_file`
+- Enhance `get_open_file`/`get_multiple_open_file` `filetypes` support to take a real Ruby hash instead of `['{Image Files} {.png}']`
+- Support `grid` keyword arg `'column_span'` (with _) and `'row_span'` as aliases for `'columnspan'` and `'rowspan'`
+
 ## 0.0.28
 
 - Hello, Drag and Drop!

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for Tk 0.0.28
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for Tk 0.0.29
 ## MRI Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-tk.svg)](http://badge.fury.io/rb/glimmer-dsl-tk)
 [![Ruby](https://github.com/AndyObtiva/glimmer-dsl-tk/actions/workflows/ruby.yml/badge.svg)](https://github.com/AndyObtiva/glimmer-dsl-tk/actions/workflows/ruby.yml)
@@ -75,6 +75,7 @@ Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems:
       - [Common Attributes](#common-attributes)
       - [Common Themed Widget States](#common-themed-widget-states)
       - [Text API](#text-api)
+      - [Drag and Drop API](#drag-and-drop-api)
     - [Smart Defaults and Conventions](#smart-defaults-and-conventions)
       - [Grid Layout](#grid-layout)
       - [Image Attribute](#image-attribute)
@@ -90,6 +91,7 @@ Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems:
     - [List Single Selection Data-Binding](#list-single-selection-data-binding)
     - [List Multi Selection Data-Binding](#list-multi-selection-data-binding)
     - [Entry Data-Binding](#entry-data-binding)
+    - [Text Data-Binding](#text-data-binding)
     - [Spinbox Data-Binding](#spinbox-data-binding)
     - [Checkbutton Data-Binding](#checkbutton-data-binding)
     - [Radiobutton Data-Binding](#radiobutton-data-binding)
@@ -113,6 +115,8 @@ Other [Glimmer](https://github.com/AndyObtiva/glimmer) DSL gems:
     - [Hello, Spinbox!](#hello-spinbox)
     - [Hello, Computed!](#hello-computed)
     - [Hello, Drag and Drop!](#hello-drag-and-drop)
+    - [Hello, Built-in Dialog!](#hello-built-in-dialog)
+    - [Hello, Separator!](#hello-separator)
   - [Help](#help)
     - [Issues](#issues)
     - [Chat](#chat)
@@ -149,7 +153,7 @@ gem install glimmer-dsl-tk
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-tk', '~> 0.0.28'
+gem 'glimmer-dsl-tk', '~> 0.0.29'
 ```
 
 And, then run:
@@ -260,8 +264,14 @@ keyword(args) | attributes | event bindings & callbacks
 ------------- | ---------- | ---------
 `button` | `text`, `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `default` (`'active', 'normal'`) | `command {}`
 `checkbutton` | `text`, `variable` (Boolean), `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `onvalue` (default: `1`), `offvalue` (default: `0`) | `command {}`
+`choose_color(options = nil)` | None | None
+`choose_directory(options = nil)` | None | None
+`choose_font(options = nil) {|font| ... }` | None | None
 `combobox` | `state`, `text` | `'ComboboxSelected'`
 `entry` | `width`, `text`, `validate`, `show` (`'none', 'focus', 'focusin', 'focusout', 'key', or 'all'`) | `'validate'`, `'invalid'`, `'change'`, `validatecommand {}`, `invalidcommand {}`
+`get_multiple_open_file(options = nil)` | None | None
+`get_open_file(options = nil)` | None | None
+`get_save_file(options = nil)` | None | None
 `spinbox` | `text`, `from`, `to`, `increment`, `format`, [more attributes](https://tcl.tk/man/tcl8.6/TkCmd/text.htm#M116) | `command {}`, `'increment'`, `'decrement'`
 `frame(text: nil)` | `width`, `height`, `borderwidth`, `relief` (`'flat' (default), 'raised', 'sunken', 'solid', 'ridge', 'groove'`) | None
 `label` | `text`, `image` (optional keyword args: `subsample`, `zoom`, `from`, `to`, `shrink`, `compositingrule`), `compound` (`'center', 'top', 'bottom', 'left', 'right'`), `font` (`'default', 'text', 'fixed', 'menu', 'heading', 'caption', 'small_caption', 'icon', 'tooltip'`), `relief` (`'flat' (default), 'raised', 'sunken', 'solid', 'ridge', 'groove'`), `justify` (`'left', 'center', 'right'`), `foreground`, `background` | None
@@ -272,6 +282,9 @@ keyword(args) | attributes | event bindings & callbacks
 `root` | `title`, `iconphoto`, `background`, `alpha`, `fullscreen?`, `topmost?`, `transparent?`, `stackorder`, `winfo_screendepth`, `winfo_screenvisual`, `winfo_screenwidth`, `winfo_screenheight`, `winfo_pixels('li')`, `winfo_screen`, `wm_maxsize`, `state` (`'normal', 'iconic', 'withdrawn', 'icon', 'zoomed'`) | `'DELETE_WINDOW'`, `'OPEN_WINDOW'`
 `text` | `text`, [many more attributes](https://tcl.tk/man/tcl8.6/TkCmd/text.htm#M116) | `'modified'`, `'selection'`
 
+Options for `get_open_file` and `get_multiple_open_file` include:
+- `filetypes`: `Hash` of `'Group Name' => '.ext'` entries (e.g. `filetypes: {'PNG Images' => '.png'}`
+
 #### Common Attributes
 
 - `grid`: `Hash` of `:row`, `:column`, `:padx`, `:pady`, `:sticky` (`'e', 'w', 'n', 's'` or any combination of direction letters)
@@ -322,9 +335,7 @@ keyword(args) | attributes | event bindings & callbacks
 
 #### Text API
 
-[Glimmer DSL for Tk](https://rubygems.org/gems/glimmer-dsl-tk) automatically provides a `text` attribute for the `text` widget that enables updating its content simply without worrying about whether to manually insert by index, delete, or append.
-
-Also, the `text` widget is enhanced by [Glimmer DSL for Tk](https://rubygems.org/gems/glimmer-dsl-tk) to enable simpler manipulation of text options without dealing with [tags](https://tkdocs.com/tutorial/text.html) directly. Simply specify region to mutate and option/value or font_option/value, and [Glimmer DSL for Tk](https://rubygems.org/gems/glimmer-dsl-tk) takes care of the rest by automating work of adding/removing [tags](https://tkdocs.com/tutorial/text.html) behind the scenes.
+The `text` widget is enhanced by [Glimmer DSL for Tk](https://rubygems.org/gems/glimmer-dsl-tk) to enable simpler manipulation of text options without dealing with [tags](https://tkdocs.com/tutorial/text.html) directly. Simply specify region to mutate and option/value or font_option/value, and [Glimmer DSL for Tk](https://rubygems.org/gems/glimmer-dsl-tk) takes care of the rest by automating work of adding/removing [tags](https://tkdocs.com/tutorial/text.html) behind the scenes.
 
 - `add_format(region_start, region_end, option, value)`
 - `remove_format(region_start, region_end, option, value)`
@@ -338,6 +349,8 @@ Also, the `text` widget is enhanced by [Glimmer DSL for Tk](https://rubygems.org
 - `add_selection_font_format(region_start, region_end, font_option, value)`
 - `remove_selection_font_format(region_start, region_end, font_option, value)`
 - `toggle_selection_font_format(region_start, region_end, font_option, value)`
+- `text#insert_image(text_index, *image_args)`: inserts image into `text` `value` content at `text_index` location (e.g. `'insert'`)
+- `text#get_open_file_to_insert_image(text_index = 'insert')`: opens a file dialog to select one of the available image formats and then inserts image into `text` `value` content
 
 Available options:
 
@@ -381,6 +394,19 @@ Other useful built-in API methods:
 
 Check out the [Hello, Text!](#hello-text) sample for a good demonstration of the `text` widget features.
 
+#### Drag and Drop API
+
+Drag and drop works by simply designating a widget as a drag source with attribute `drag_source true`
+
+Alternatively, add listeners:
+- `on_drag_start {|event| ...}`: fires on drag start receiving an `event` arg to set `data` and configure `source`
+- `on_drag_motion {|event| ...}`: fires on drag motion receiving an `event` arg to check `event#drop_accepted`, and configure `source` and `tooltip`
+
+On the drop target, you simply define:
+- `on_drop { |event| ...}`: fires on drop, receiving an `event` arg with `event#target` and `event#data` (set during drag). You can even destroy the `event#source` if you want to get rid of the dragged widget.
+
+Learn more at the [Hello, Drag and Drop!](#hello-drag-and-drop) sample.
+
 ### Smart Defaults and Conventions
 
 #### Event Bindings
@@ -466,6 +492,8 @@ Example:
 ```
 
 Extra convenience options may be passed to `grid` when using [Glimmer DSL for Tk](https://rubygems.org/gems/glimmer-dsl-tk):
+- `column_span`: alias for `columnspan` keyword arg
+- `row_span`: alias for `rowspan` keyword arg
 - `min_width`: alias for `columnminsize` being called on `TkGrid.columnconfigure`
 - `min_height`: alias for `rowminsize` being called on `TkGrid.rowconfigure`
 - `column_weight`: alias for `columnweight` being called on `TkGrid.columnconfigure`
@@ -578,6 +606,24 @@ It automatically handles all the Tk plumbing behind the scenes.
 
 More details can be found in [Hello, Entry!](#hello-entry) and [Hello, Computed!](#hello-computed) samples below.
 
+### Text Data-Binding
+
+Example:
+
+This assumes a `Person` model with a `biography` attribute.
+
+```ruby
+  text {
+    value <=> [person, :biography]
+  }
+```
+
+That code binds the `value` of `text` to the `biography` attribute on the `person` model.
+
+It automatically handles all the Tk plumbing behind the scenes.
+
+More details can be found in [Hello, Text!](#hello-text) sample below.
+
 ### Spinbox Data-Binding
 
 Example:
@@ -698,6 +744,128 @@ ruby -r ./lib/glimmer-dsl-tk.rb samples/elaborate/meta_sample.rb
 
 ![glimmer dsl tk screenshot sample meta sample](images/glimmer-dsl-tk-screenshot-sample-elaborate-meta-sample.png)
 
+Code:
+
+```ruby
+require 'glimmer-dsl-tk'
+require 'facets'
+require 'fileutils'
+
+class MetaSample
+  include Glimmer
+  
+  attr_accessor :selected_sample_index
+  
+  def initialize
+    @selected_sample_index = 0
+  end
+  
+  def samples
+    if @samples.nil?
+      sample_files = Dir.glob(File.join(File.expand_path('../hello', __dir__), '**', 'hello_*.rb'))
+      sample_file_names = sample_files.map { |f| File.basename(f, '.rb') }
+      sample_file_names = sample_file_names.reject { |f| f == 'meta_sample' || f.match(/\d$/) }
+      @samples = sample_file_names.map { |f| f.underscore.titlecase }
+    end
+    @samples
+  end
+  
+  def file_path_for(sample)
+    File.join(File.expand_path('../hello', __dir__), "#{sample.underscore}.rb")
+  end
+  
+  def glimmer_dsl_tk_file
+    File.expand_path('../../lib/glimmer-dsl-tk', __dir__)
+  end
+  
+  def selected_sample
+    samples[@selected_sample_index]
+  end
+  
+  def run_sample(sample)
+    Thread.new do
+      command = "ruby -r #{glimmer_dsl_tk_file} #{sample} 2>&1"
+      result = ''
+      IO.popen(command) do |f|
+        f.each_line do |line|
+          result << line
+          puts line
+          $stdout.flush
+        end
+      end
+      ::Tk.after(100) do
+        message_box(parent: @root, title: 'Error Running Sample', message: result) if result.downcase.include?('error')
+      end
+    end
+  end
+  
+  def launch
+    @root = root {
+      title 'Glimmer Meta-Sample'
+      width 1280
+      height 720
+      
+      frame {
+        grid row: 0, column: 0, column_weight: 0, row_weight: 1
+        
+        samples.each_with_index do |sample, index|
+          radiobutton {
+            text sample
+            variable <=> [self, :selected_sample_index, on_write: ->(v) {v ? index : selected_sample_index}, on_read: ->(v) {v == index}]
+            
+            on('command') do
+              @selected_sample_index = index
+              @code_text.value = File.read(file_path_for(selected_sample))
+            end
+          }
+        end
+        
+        frame {
+          button {
+            grid row: 0, column: 0
+            text 'Launch'
+            
+            on('command') do
+              begin
+                parent_dir = File.join(Dir.home, '.glimmer-dsl-tk', 'samples', 'hello')
+                FileUtils.mkdir_p(parent_dir)
+                sample_file = File.join(parent_dir, "#{selected_sample.underscore}.rb")
+                File.write(sample_file, @code_text.value)
+                FileUtils.cp_r(File.expand_path('../../icons', __dir__), File.dirname(File.dirname(parent_dir)))
+                FileUtils.cp_r(File.expand_path('../hello/images', __dir__), parent_dir)
+                sample_namespace_directory = File.expand_path("../hello/#{selected_sample.underscore}", __dir__)
+                FileUtils.cp_r(sample_namespace_directory, parent_dir) if Dir.exist?(sample_namespace_directory)
+                run_sample(sample_file)
+              rescue => e
+                puts e.full_message
+                puts 'Unable to write code changes! Running original sample...'
+                run_sample(file_path_for(selected_sample))
+              end
+            end
+          }
+          button {
+            grid row: 0, column: 1
+            text 'Reset'
+            
+            on('command') do
+              @code_text.value = File.read(file_path_for(selected_sample))
+            end
+          }
+        }
+      }
+      
+      @code_text = text {
+        grid row: 0, column: 1, column_weight: 1
+        value File.read(file_path_for(selected_sample))
+      }
+    }
+    @root.open
+  end
+end
+
+MetaSample.new.launch
+```
+
 ### Hello, World!
 
 Glimmer code (from [samples/hello/hello_world.rb](samples/hello/hello_world.rb)):
@@ -1389,8 +1557,6 @@ root { |r|
   title 'Hello, Message Box!'
   
   frame {
-    grid sticky: 'nsew', padx: 15, pady: 15
-    
     button {
       text 'Please Click To Win a Surprise'
       
@@ -1442,8 +1608,6 @@ root { |r|
   }
   
   frame {
-    grid sticky: 'nsew', padx: 15, pady: 15
-    
     label {
       grid row: 0, column: 0
       text 'Result:'
@@ -1471,7 +1635,6 @@ ruby -r ./lib/glimmer-dsl-tk.rb samples/hello/hello_message_box.rb
 Glimmer app:
 
 ![glimmer dsl tk screenshot sample hello message box](images/glimmer-dsl-tk-screenshot-sample-hello-message-box.png)
-![glimmer dsl tk screenshot sample hello message box open](images/glimmer-dsl-tk-screenshot-sample-hello-message-box-open.png)
 
 ### Hello, Combobox!
 
@@ -1711,12 +1874,17 @@ class HelloText
   include Glimmer
   
   COLOR_OPTIONS = %w[black purple blue green orange yellow red white].map(&:capitalize)
-  FOREGROUND_PROMPT = '<select foreground>'
-  BACKGROUND_PROMPT = '<select background>'
+  FONT_FAMILY_OPTIONS = ::TkFont.families
+  FOREGROUND_PROMPT = '<foreground>'
+  BACKGROUND_PROMPT = '<background>'
+  FONT_FAMILY_PROMPT = '<font family>'
+  FONT_SIZE_PROMPT = '<font size>'
   
   def initialize
     @foreground = FOREGROUND_PROMPT
     @background = BACKGROUND_PROMPT
+    @font_family = FONT_FAMILY_PROMPT
+    @font_size = FONT_SIZE_PROMPT
   end
   
   attr_accessor :foreground
@@ -1731,6 +1899,18 @@ class HelloText
     [BACKGROUND_PROMPT] + COLOR_OPTIONS
   end
   
+  attr_accessor :font_family
+  
+  def font_family_options
+    [FONT_FAMILY_PROMPT] + FONT_FAMILY_OPTIONS
+  end
+  
+  attr_accessor :font_size
+  
+  def font_size_options
+    [FONT_SIZE_PROMPT] + (9..64).to_a.map(&:to_s)
+  end
+  
   def launch
     root {
       title 'Hello, Text!'
@@ -1738,8 +1918,39 @@ class HelloText
       frame {
         grid row: 0, column: 0
         
+        column_index = -1
+        
+        combobox {
+          grid row: 0, column: column_index += 1, column_weight: 1
+          readonly true
+          text <=> [self, :font_family, after_write: ->(value) { @text.toggle_selection_font_format('family', value == FONT_FAMILY_PROMPT ? 'Courier New' : value) }]
+        }
+        
+        combobox {
+          grid row: 0, column: column_index += 1, column_weight: 1
+          readonly true
+          text <=> [self, :font_size, after_write: ->(value) { @text.toggle_selection_font_format('size', value == FONT_SIZE_PROMPT ? 13 : value) }]
+        }
+        
+        combobox {
+          grid row: 0, column: column_index += 1, column_weight: 1
+          readonly true
+          text <=> [self, :foreground, after_write: ->(value) { @text.add_selection_format('foreground', value == FOREGROUND_PROMPT ? 'black' : value) }]
+        }
+        
+        combobox {
+          grid row: 0, column: column_index += 1, column_weight: 1
+          readonly true
+          text <=> [self, :background, after_write: ->(value) { @text.add_selection_format('background', value == BACKGROUND_PROMPT ? 'white' : value) }]
+        }
+        
+        separator {
+          grid row: 0, column: column_index += 1, column_weight: 0
+          orient 'vertical'
+        }
+        
         button {
-          grid row: 0, column: 0, column_weight: 0
+          grid row: 0, column: column_index += 1, column_weight: 0
           text 'B'
           style font: {weight: 'bold'}
           
@@ -1749,7 +1960,7 @@ class HelloText
         }
         
         button {
-          grid row: 0, column: 1, column_weight: 0
+          grid row: 0, column: column_index += 1, column_weight: 0
           text 'I'
           style font: {slant: 'italic'}
           
@@ -1759,7 +1970,7 @@ class HelloText
         }
         
         button {
-          grid row: 0, column: 2, column_weight: 0
+          grid row: 0, column: column_index += 1, column_weight: 0
           text 'U'
           style font: {underline: true}
           
@@ -1768,23 +1979,67 @@ class HelloText
           end
         }
         
-        combobox {
-          grid row: 0, column: 4, column_weight: 1
-          readonly true
-          text <=> [self, :foreground, after_write: ->(value) { @text.add_selection_format('foreground', value == FOREGROUND_PROMPT ? 'black' : value) }]
+        separator {
+          grid row: 0, column: column_index += 1, column_weight: 0
+          orient 'vertical'
         }
         
-        combobox {
-          grid row: 0, column: 5, column_weight: 1
-          readonly true
-          text <=> [self, :background, after_write: ->(value) { @text.add_selection_format('background', value == BACKGROUND_PROMPT ? 'black' : value) }]
+        button {
+          grid row: 0, column: column_index += 1, column_weight: 0
+          image File.expand_path("images/cut.png", __dir__), subsample: 32
+          
+          on('command') do
+            @text.text_cut
+          end
+        }
+        
+        button {
+          grid row: 0, column: column_index += 1, column_weight: 0
+          image File.expand_path("images/copy.png", __dir__), subsample: 32
+          
+          on('command') do
+            @text.text_copy
+          end
+        }
+        
+        button {
+          grid row: 0, column: column_index += 1, column_weight: 0
+          image File.expand_path("images/paste.png", __dir__), subsample: 32
+          
+          on('command') do
+            @text.text_paste
+          end
+        }
+        
+        separator {
+          grid row: 0, column: column_index += 1, column_weight: 0
+          orient 'vertical'
+        }
+        
+        button {
+          grid row: 0, column: column_index += 1, column_weight: 0
+          image File.expand_path("images/undo.png", __dir__), subsample: 32
+          
+          on('command') do
+            @text.edit_undo
+          end
+        }
+        
+        button {
+          grid row: 0, column: column_index += 1, column_weight: 0
+          image File.expand_path("images/redo.png", __dir__), subsample: 32
+          
+          on('command') do
+            @text.edit_redo
+          end
         }
       }
       
       @text = text {
         grid row: 1, column: 0, row_weight: 1
         wrap 'word'
-        text <<~MULTI_LINE_STRING
+        undo true
+        value <<~MULTI_LINE_STRING
           According to the National Post, a heavy metal-loving high school principal in Canada will be allowed to keep her job, days after a public campaign to oust her made headlines around the globe.
           
           Parents at Eden High School in St. Catharines, Ontario launched a petition to remove principal Sharon Burns after discovering she's an IRON MAIDEN fan.
@@ -2152,6 +2407,154 @@ Glimmer app:
 
 ![glimmer dsl tk screenshot sample hello drag and drop](images/glimmer-dsl-tk-screenshot-sample-hello-drag-and-drop.png)
 
+### Hello, Built-in Dialog!
+
+Glimmer code (from [samples/hello/hello_built_in_dialog.rb](samples/hello/hello_built_in_dialog.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
+include Glimmer
+
+root { |w|
+  title 'Hello, Built-in Dialog!'
+  width 400
+  height 400
+  x 150
+  y 150
+  
+  frame {
+    %w[get_open_file get_multiple_open_file get_save_file choose_directory choose_color].each do |dialog|
+      button {
+        text dialog.split('_').map(&:capitalize).join(' ')
+        
+        on('command') do
+          result = send(dialog, parent: w)
+          @result_label.text = [result].flatten.join("\n")
+        end
+      }
+    end
+    
+    button {
+      text 'Choose Font'
+      
+      on('command') do
+        choose_font(family: 'Courier New', size: '30', weight: 'bold') do |chosen_font|
+          @result_label.text = chosen_font(parent: w)
+        end
+      end
+    }
+  }
+  
+  frame {
+    grid sticky: 'nsew', padx: 15, pady: 15
+    
+    label {
+      grid row: 0, column: 0
+      text 'Result:'
+    }
+    
+    @result_label = label {
+      grid row: 0, column: 1
+    }
+  }
+}.open
+```
+
+Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_built_in_dialog'"
+```
+
+Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r ./lib/glimmer-dsl-tk.rb samples/hello/hello_built_in_dialog.rb
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello built in dialog 1](images/glimmer-dsl-tk-screenshot-sample-hello-built-in-dialog-get-open-file.png)
+![glimmer dsl tk screenshot sample hello built in dialog 2](images/glimmer-dsl-tk-screenshot-sample-hello-built-in-dialog-get-open-file-done.png)
+
+![glimmer dsl tk screenshot sample hello built in dialog 3](images/glimmer-dsl-tk-screenshot-sample-hello-built-in-dialog-choose-color.png)
+![glimmer dsl tk screenshot sample hello built in dialog 4](images/glimmer-dsl-tk-screenshot-sample-hello-built-in-dialog-choose-color-done.png)
+
+![glimmer dsl tk screenshot sample hello built in dialog 5](images/glimmer-dsl-tk-screenshot-sample-hello-built-in-dialog-choose-font.png)
+![glimmer dsl tk screenshot sample hello built in dialog 6](images/glimmer-dsl-tk-screenshot-sample-hello-built-in-dialog-choose-font-done.png)
+
+### Hello, Separator!
+
+Glimmer code (from [samples/hello/hello_separator.rb](samples/hello/hello_separator.rb)):
+
+```ruby
+require 'glimmer-dsl-tk'
+
+include Glimmer
+
+root {
+  title 'Hello, Separator!'
+  width 200
+  height 200
+  
+  label {
+    grid row: 0, column: 0, min_width: 100, min_height: 100, column_weight: 0, sticky: 'nsew'
+    text 'Label 1'
+    anchor 'center'
+  }
+  
+  separator {
+    grid row: 0, column: 1
+    orient 'vertical'
+  }
+  
+  label {
+    grid row: 0, column: 2, min_width: 100, min_height: 100, sticky: 'nsew'
+    text 'Label 2'
+    anchor 'center'
+  }
+  
+  separator {
+    grid row: 1, column: 0, column_span: 3
+    orient 'horizontal'
+  }
+  
+  label {
+    grid row: 2, column: 0, min_width: 100, min_height: 100, sticky: 'nsew'
+    text 'Label 3'
+    anchor 'center'
+  }
+  
+  separator {
+    grid row: 2, column: 1
+    orient 'vertical'
+  }
+  
+  label {
+    grid row: 2, column: 2, min_width: 100, min_height: 100, sticky: 'nsew'
+    text 'Label 4'
+    anchor 'center'
+  }
+}.open
+```
+
+Run with [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r glimmer-dsl-tk -e "require 'samples/hello/hello_separator'"
+```
+
+Alternatively, run from cloned project without [glimmer-dsl-tk](https://rubygems.org/gems/glimmer-dsl-tk) gem installed:
+
+```
+ruby -r ./lib/glimmer-dsl-tk.rb samples/hello/hello_separator.rb
+```
+
+Glimmer app:
+
+![glimmer dsl tk screenshot sample hello separator](images/glimmer-dsl-tk-screenshot-sample-hello-separator.png)
+
 ## Help
 
 ### Issues

data/VERSION

@@ -1 +1 @@
-0.0.28
+0.0.29

data/lib/glimmer/dsl/tk/built_in_dialog_expression.rb

@@ -0,0 +1,57 @@
+# Copyright (c) 2020-2021 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer'
+require 'glimmer/dsl/expression'
+
+module Glimmer
+  module DSL
+    module Tk
+      class BuiltInDialogExpression < Expression
+        def can_interpret?(parent, keyword, *args, &block)
+          keyword = "get_#{keyword}" if keyword.start_with?('open')
+          (keyword.start_with?('get') or keyword.start_with?('choose')) and
+          (
+            (block.nil? and ::Tk.respond_to?(keyword.camelcase)) or
+            keyword == 'choose_font'
+          )
+        end
+  
+        def interpret(parent, keyword, *args, &block)
+          if args.first.is_a?(Hash)
+            options = args.first.symbolize_keys
+            options[:filetypes] = options.delete(:file_types) if options.keys.include?(:file_types)
+            options[:filetypes] = options[:filetypes].map { |key, value| "{#{key}} {#{value}}" } if options[:filetypes].is_a?(Hash)
+            options[:parent] = options[:parent].tk if options[:parent].is_a?(Glimmer::Tk::RootProxy)
+            args[0] = options
+          end
+          keyword = "get_#{keyword}" if keyword.start_with?('open') || keyword.start_with?('save') || keyword.start_with?('multiple')
+          if keyword == 'choose_font'
+            TkFont::Fontchooser.configure(:font => args, :command => block)
+            TkFont::Fontchooser.show
+          else
+            ::Tk.send(keyword.camelcase, *args)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/glimmer/dsl/tk/dsl.rb

@@ -42,6 +42,7 @@ module Glimmer
           attribute
           shine_data_binding
           widget
+          built_in_dialog
         ]
       )
     end

data/lib/glimmer/tk/text_proxy.rb

@@ -43,22 +43,6 @@ module Glimmer
         end
       end
     
-      def text=(value)
-        if value != @text
-          if @text && value.start_with?(@text)
-            insert('end', value[@text.size..-1])
-          else
-            delete('1.0', 'end')
-            insert('end', value)
-          end
-          @text = value
-        end
-      end
-      
-      def text
-        @text = get("1.0", 'end')
-      end
-      
       def add_selection_format(option, value)
         process_selection_ranges { |range_start, range_end| add_format(range_start, range_end, option, value) }
       end
@@ -158,7 +142,7 @@ module Glimmer
       end
 
       def applied_font_format_tags_and_regions(region_start, region_end)
-        lines = text.split("\n")
+        lines = value.split("\n")
         tags_and_regions = []
         all_tag_names = @tk.tag_names - ['sel']
         (region_start.to_i..region_end.to_i).each do |line_number|
@@ -332,8 +316,17 @@ module Glimmer
         region1_parts.last.to_i >= region2_parts.last.to_i
       end
       
-      def clone_font(font)
-        ::TkFont.new(Hash[font.actual])
+      def insert_image(text_index, *image_args)
+        TkTextImage.new(@tk, 'insert', :image => image_argument(image_args))
+      end
+      
+      def get_open_file_to_insert_image(text_index = 'insert')
+        image_filename = Glimmer::DSL::Tk::BuiltInDialogExpression.new.interpret(nil, 'get_open_file', filetypes: {
+          'PNG Images' => '.png',
+          'Gif Images' => '.gif',
+          'PPM Images' => '.ppm'
+        })
+        insert_image('insert', image_filename) unless image_filename.nil? || image_filename.to_s.empty?
       end
       
       private
@@ -345,6 +338,10 @@ module Glimmer
         self.padx = 5
         self.pady = 5
       end
+      
+      def clone_font(font)
+        ::TkFont.new(Hash[font.actual])
+      end
     end
   end
 end

data/lib/glimmer/tk/widget_proxy.rb

@@ -228,6 +228,8 @@ module Glimmer
       def grid(options = {})
         options = options.stringify_keys
         index_in_parent = @parent_proxy.children.index(self)
+        options['rowspan'] = options.delete('row_span') if options.keys.include?('row_span')
+        options['columnspan'] = options.delete('column_span') if options.keys.include?('column_span')
         options['rowweight'] = options.delete('row_weight') if options.keys.include?('row_weight')
         options['columnweight'] = options.delete('column_weight') if options.keys.include?('column_weight')
         options['columnweight'] = options['rowweight'] = options.delete('weight')  if options.keys.include?('weight')
@@ -379,9 +381,9 @@ module Glimmer
             end,
           },
           ::Tk::Text => {
-            'text' => lambda do |observer|
+            'value' => lambda do |observer|
               handle_listener('modified') do
-                observer.call(text)
+                observer.call(value)
               end
             end,
           },
@@ -422,6 +424,7 @@ module Glimmer
         begin
           @tk.bind(listener_name, &listener)
         rescue => e
+          Glimmer::Config.logger.debug {"Unable to bind to #{listener_name} .. attempting to surround with <>"}
           Glimmer::Config.logger.debug {e.full_message}
           listener_name = "<#{listener_name}" if !listener_name.start_with?('<')
           listener_name = "#{listener_name}>" if !listener_name.end_with?('>')

data/samples/elaborate/meta_sample.rb

@@ -87,7 +87,7 @@ class MetaSample
             
             on('command') do
               @selected_sample_index = index
-              @code_text.text = File.read(file_path_for(selected_sample))
+              @code_text.value = File.read(file_path_for(selected_sample))
             end
           }
         end
@@ -102,7 +102,7 @@ class MetaSample
                 parent_dir = File.join(Dir.home, '.glimmer-dsl-tk', 'samples', 'hello')
                 FileUtils.mkdir_p(parent_dir)
                 sample_file = File.join(parent_dir, "#{selected_sample.underscore}.rb")
-                File.write(sample_file, @code_text.text)
+                File.write(sample_file, @code_text.value)
                 FileUtils.cp_r(File.expand_path('../../icons', __dir__), File.dirname(File.dirname(parent_dir)))
                 FileUtils.cp_r(File.expand_path('../hello/images', __dir__), parent_dir)
                 sample_namespace_directory = File.expand_path("../hello/#{selected_sample.underscore}", __dir__)
@@ -120,7 +120,7 @@ class MetaSample
             text 'Reset'
             
             on('command') do
-              @code_text.text = File.read(file_path_for(selected_sample))
+              @code_text.value = File.read(file_path_for(selected_sample))
             end
           }
         }
@@ -128,7 +128,7 @@ class MetaSample
       
       @code_text = text {
         grid row: 0, column: 1, column_weight: 1
-        text File.read(file_path_for(selected_sample))
+        value File.read(file_path_for(selected_sample))
       }
     }
     @root.open

data/samples/hello/hello_built_in_dialog.rb

@@ -0,0 +1,68 @@
+# Copyright (c) 2020-2021 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer-dsl-tk'
+
+include Glimmer
+
+root { |w|
+  title 'Hello, Built-in Dialog!'
+  width 400
+  height 400
+  x 150
+  y 150
+  
+  frame {
+    %w[get_open_file get_multiple_open_file get_save_file choose_directory choose_color].each do |dialog|
+      button {
+        text dialog.split('_').map(&:capitalize).join(' ')
+        
+        on('command') do
+          result = send(dialog, parent: w)
+          @result_label.text = [result].flatten.join("\n")
+        end
+      }
+    end
+    
+    button {
+      text 'Choose Font'
+      
+      on('command') do
+        choose_font(family: 'Courier New', size: '30', weight: 'bold') do |chosen_font|
+          @result_label.text = chosen_font(parent: w)
+        end
+      end
+    }
+  }
+  
+  frame {
+    grid sticky: 'nsew', padx: 15, pady: 15
+    
+    label {
+      grid row: 0, column: 0
+      text 'Result:'
+    }
+    
+    @result_label = label {
+      grid row: 0, column: 1
+    }
+  }
+}.open

data/samples/hello/hello_message_box.rb

@@ -27,8 +27,6 @@ root { |r|
   title 'Hello, Message Box!'
   
   frame {
-    grid sticky: 'nsew', padx: 15, pady: 15
-    
     button {
       text 'Please Click To Win a Surprise'
       
@@ -80,8 +78,6 @@ root { |r|
   }
   
   frame {
-    grid sticky: 'nsew', padx: 15, pady: 15
-    
     label {
       grid row: 0, column: 0
       text 'Result:'

data/samples/hello/hello_separator.rb

@@ -0,0 +1,69 @@
+# Copyright (c) 2020-2021 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer-dsl-tk'
+
+include Glimmer
+
+root {
+  title 'Hello, Separator!'
+  width 200
+  height 200
+  
+  label {
+    grid row: 0, column: 0, min_width: 100, min_height: 100, column_weight: 0, sticky: 'nsew'
+    text 'Label 1'
+    anchor 'center'
+  }
+  
+  separator {
+    grid row: 0, column: 1
+    orient 'vertical'
+  }
+  
+  label {
+    grid row: 0, column: 2, min_width: 100, min_height: 100, sticky: 'nsew'
+    text 'Label 2'
+    anchor 'center'
+  }
+  
+  separator {
+    grid row: 1, column: 0, column_span: 3
+    orient 'horizontal'
+  }
+  
+  label {
+    grid row: 2, column: 0, min_width: 100, min_height: 100, sticky: 'nsew'
+    text 'Label 3'
+    anchor 'center'
+  }
+  
+  separator {
+    grid row: 2, column: 1
+    orient 'vertical'
+  }
+  
+  label {
+    grid row: 2, column: 2, min_width: 100, min_height: 100, sticky: 'nsew'
+    text 'Label 4'
+    anchor 'center'
+  }
+}.open

data/samples/hello/hello_text.rb

@@ -36,8 +36,36 @@ class HelloText
     @background = BACKGROUND_PROMPT
     @font_family = FONT_FAMILY_PROMPT
     @font_size = FONT_SIZE_PROMPT
+    @document = <<~MULTI_LINE_STRING
+      According to the National Post, a heavy metal-loving high school principal in Canada will be allowed to keep her job, days after a public campaign to oust her made headlines around the globe.
+      
+      Parents at Eden High School in St. Catharines, Ontario launched a petition to remove principal Sharon Burns after discovering she's an IRON MAIDEN fan.
+      
+      The petition, titled "Eden High School Principal, Sharon Burns, Needs to Be Transferred Immediately!" read, "We are deeply disturbed that the principal assigned to the school blatantly showed Satanic symbols and her allegiance to Satanic practices on her public social media platforms where all the students can see them under @edenprincipal (not her personal account)."
+      
+      More than 500 people signed the petition to transfer Burns after she posted a picture of herself flashing the "devil horns" hand sign with a doll of the MAIDEN zombie mascot Eddie behind her as well as a personalized license plate reading "IRNMADEN" and a handwritten note that reads "Eddie 666" on a car's dashboard.
+      
+      
+      The number 666 is used to represent the devil, and is featured prominently in MAIDEN's artwork by the band, whose classic third album is titled "The Number Of The Beast".
+      
+      The petition was later updated to state that the demand for her transfer is not because of her love for metal, but for "openly displaying her own handmade sign with the 666 clearly displayed on it".
+      
+      The creator of the original petition wrote: "Sharon knows full well what she did was simply inappropriate, unnecessary and not professional but has yet to publicly admit so and is willing to allow people to believe a completely different story, making very real concerns seem petty."
+      
+      Meanwhile, a counter-petition supporting Burns garnered over 20,000 signatures.
+      
+      "It is ridiculous that a couple of parents judge her role as a principal only based on an Instagram post. (About liking the band IRON MAIDEN. That's it.) Eden High School is a public school. Not a Christian school," the petition titled "We need Mrs Burns" stated. "She has made Eden a safe space for so many people. She spreads nothing but love and kindness."
+      
+      After the complaints were aired, the District School Board of Niagara spoke with Burns and the parents who launched the petition, and the issue is over as far as the board is concerned, Kim Sweeney, the board's chief communications officer, told the National Post. No disciplinary action or policy changes were needed.
+      
+      "Our belief is that taste in music is subjective and we support that both students and staff enjoy a wide variety of genres," Sweeney said.
+      
+      The original petition has since been removed.
+    MULTI_LINE_STRING
   end
   
+  attr_accessor :document
+      
   attr_accessor :foreground
   
   def foreground_options
@@ -69,37 +97,44 @@ class HelloText
       frame {
         grid row: 0, column: 0
         
+        label {
+          grid row: 0, column: 0, columnspan: 17
+          text 'Select a region of text and then apply formatting from the toolbar'
+        }
+        
+        column_index = -1
+        
         combobox {
-          grid row: 0, column: 0, column_weight: 1
+          grid row: 1, column: column_index += 1, column_weight: 1
           readonly true
           text <=> [self, :font_family, after_write: ->(value) { @text.toggle_selection_font_format('family', value == FONT_FAMILY_PROMPT ? 'Courier New' : value) }]
         }
         
         combobox {
-          grid row: 0, column: 1, column_weight: 1
+          grid row: 1, column: column_index += 1, column_weight: 1
           readonly true
           text <=> [self, :font_size, after_write: ->(value) { @text.toggle_selection_font_format('size', value == FONT_SIZE_PROMPT ? 13 : value) }]
         }
         
         combobox {
-          grid row: 0, column: 2, column_weight: 1
+          grid row: 1, column: column_index += 1, column_weight: 1
           readonly true
           text <=> [self, :foreground, after_write: ->(value) { @text.add_selection_format('foreground', value == FOREGROUND_PROMPT ? 'black' : value) }]
         }
         
         combobox {
-          grid row: 0, column: 3, column_weight: 1
+          grid row: 1, column: column_index += 1, column_weight: 1
           readonly true
           text <=> [self, :background, after_write: ->(value) { @text.add_selection_format('background', value == BACKGROUND_PROMPT ? 'white' : value) }]
         }
         
         separator {
-          grid row: 0, column: 4, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           orient 'vertical'
         }
         
         button {
-          grid row: 0, column: 5, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           text 'B'
           style font: {weight: 'bold'}
           
@@ -109,7 +144,7 @@ class HelloText
         }
         
         button {
-          grid row: 0, column: 6, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           text 'I'
           style font: {slant: 'italic'}
           
@@ -119,7 +154,7 @@ class HelloText
         }
         
         button {
-          grid row: 0, column: 7, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           text 'U'
           style font: {underline: true}
           
@@ -129,12 +164,12 @@ class HelloText
         }
         
         separator {
-          grid row: 0, column: 8, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           orient 'vertical'
         }
         
         button {
-          grid row: 0, column: 9, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           image File.expand_path("images/cut.png", __dir__), subsample: 32
           
           on('command') do
@@ -143,7 +178,7 @@ class HelloText
         }
         
         button {
-          grid row: 0, column: 10, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           image File.expand_path("images/copy.png", __dir__), subsample: 32
           
           on('command') do
@@ -152,7 +187,7 @@ class HelloText
         }
         
         button {
-          grid row: 0, column: 11, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           image File.expand_path("images/paste.png", __dir__), subsample: 32
           
           on('command') do
@@ -161,12 +196,12 @@ class HelloText
         }
         
         separator {
-          grid row: 0, column: 12, column_weight: 0
+          grid row: 1, column: column_index += 1, column_weight: 0
           orient 'vertical'
         }
         
         button {
-          grid row: 0, column: 13, column_weight: 1
+          grid row: 1, column: column_index += 1, column_weight: 0
           image File.expand_path("images/undo.png", __dir__), subsample: 32
           
           on('command') do
@@ -175,45 +210,34 @@ class HelloText
         }
         
         button {
-          grid row: 0, column: 14, column_weight: 1
+          grid row: 1, column: column_index += 1, column_weight: 0
           image File.expand_path("images/redo.png", __dir__), subsample: 32
           
           on('command') do
             @text.edit_redo
           end
         }
+        
+        separator {
+          grid row: 1, column: column_index += 1, column_weight: 0
+          orient 'vertical'
+        }
+        
+        button {
+          grid row: 1, column: column_index += 1, column_weight: 0
+          image File.expand_path("images/picture.png", __dir__), subsample: 32
+          
+          on('command') do
+            @text.get_open_file_to_insert_image
+          end
+        }
       }
       
       @text = text {
         grid row: 1, column: 0, row_weight: 1
         wrap 'word'
         undo true
-        text <<~MULTI_LINE_STRING
-          According to the National Post, a heavy metal-loving high school principal in Canada will be allowed to keep her job, days after a public campaign to oust her made headlines around the globe.
-          
-          Parents at Eden High School in St. Catharines, Ontario launched a petition to remove principal Sharon Burns after discovering she's an IRON MAIDEN fan.
-          
-          The petition, titled "Eden High School Principal, Sharon Burns, Needs to Be Transferred Immediately!" read, "We are deeply disturbed that the principal assigned to the school blatantly showed Satanic symbols and her allegiance to Satanic practices on her public social media platforms where all the students can see them under @edenprincipal (not her personal account)."
-          
-          More than 500 people signed the petition to transfer Burns after she posted a picture of herself flashing the "devil horns" hand sign with a doll of the MAIDEN zombie mascot Eddie behind her as well as a personalized license plate reading "IRNMADEN" and a handwritten note that reads "Eddie 666" on a car's dashboard.
-          
-          
-          The number 666 is used to represent the devil, and is featured prominently in MAIDEN's artwork by the band, whose classic third album is titled "The Number Of The Beast".
-          
-          The petition was later updated to state that the demand for her transfer is not because of her love for metal, but for "openly displaying her own handmade sign with the 666 clearly displayed on it".
-          
-          The creator of the original petition wrote: "Sharon knows full well what she did was simply inappropriate, unnecessary and not professional but has yet to publicly admit so and is willing to allow people to believe a completely different story, making very real concerns seem petty."
-          
-          Meanwhile, a counter-petition supporting Burns garnered over 20,000 signatures.
-          
-          "It is ridiculous that a couple of parents judge her role as a principal only based on an Instagram post. (About liking the band IRON MAIDEN. That's it.) Eden High School is a public school. Not a Christian school," the petition titled "We need Mrs Burns" stated. "She has made Eden a safe space for so many people. She spreads nothing but love and kindness."
-          
-          After the complaints were aired, the District School Board of Niagara spoke with Burns and the parents who launched the petition, and the issue is over as far as the board is concerned, Kim Sweeney, the board's chief communications officer, told the National Post. No disciplinary action or policy changes were needed.
-          
-          "Our belief is that taste in music is subjective and we support that both students and staff enjoy a wide variety of genres," Sweeney said.
-          
-          The original petition has since been removed.
-        MULTI_LINE_STRING
+        value <=> [self, :document]
       }
     }.open
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-tk
 version: !ruby/object:Gem::Version
-  version: 0.0.28
+  version: 0.0.29
 platform: ruby
 authors:
 - AndyMaleh
@@ -215,6 +215,7 @@ files:
 - lib/glimmer/dsl/tk/attribute_expression.rb
 - lib/glimmer/dsl/tk/bind_expression.rb
 - lib/glimmer/dsl/tk/block_attribute_expression.rb
+- lib/glimmer/dsl/tk/built_in_dialog_expression.rb
 - lib/glimmer/dsl/tk/data_binding_expression.rb
 - lib/glimmer/dsl/tk/dsl.rb
 - lib/glimmer/dsl/tk/format_expression.rb
@@ -243,6 +244,7 @@ files:
 - lib/glimmer/tk/variable_owner.rb
 - lib/glimmer/tk/widget_proxy.rb
 - samples/elaborate/meta_sample.rb
+- samples/hello/hello_built_in_dialog.rb
 - samples/hello/hello_button.rb
 - samples/hello/hello_checkbutton.rb
 - samples/hello/hello_combobox.rb
@@ -258,6 +260,7 @@ files:
 - samples/hello/hello_notebook.rb
 - samples/hello/hello_radiobutton.rb
 - samples/hello/hello_root.rb
+- samples/hello/hello_separator.rb
 - samples/hello/hello_spinbox.rb
 - samples/hello/hello_text.rb
 - samples/hello/hello_world.rb
@@ -272,7 +275,9 @@ files:
 - samples/hello/images/netherlands.png
 - samples/hello/images/norway.png
 - samples/hello/images/paste.png
+- samples/hello/images/picture.png
 - samples/hello/images/redo.png
+- samples/hello/images/search.png
 - samples/hello/images/undo.png
 - samples/hello/images/usa.png
 homepage: http://github.com/AndyObtiva/glimmer-dsl-tk