wxruby 1.9.0-i686-darwin8.4.1

data/samples/dialogs/tips.txt

@@ -0,0 +1,18 @@
+Startup tips are documented in the "Startup tips overview" section of wxWindows documentation.
+These tips are being read from the tips.txt text file in this directory. Each line of the file contains a single tip.
+If you close and open this tips dialog, you will notice that the tip numbers start at the point you were at when you closed the dialog last time. This allows easy cycling through the entire list of tips, instead of always showing the initial tips over and over.
+Often you will want to save to the application's wxConfig, the last tip that the user saw, as well as whether they want to see tips on startup.
+Comments in the tips file have a # as the first character. Comments are automatically skipped over. See the tips.txt file in this directory for the example.
+# This line is a comment since it started with a #, and is skipped.
+Blank lines in the tip file are also automatically skipped over. Lines with only spaces are also considered empty.
+The next line in this tip file is empty, so it will be automatically skipped.
+
+The next line in this tip file is just empty spaces, so it is considered empty too, and is also automatically skipped.
+  
+You can easily add translations to your startup tips via the usual gettext methods by wrapping a string in a gettext macro, which is _(""). See next tip for example.
+_("This tip is marked as a translatable string by wrapping it inside the usual gettext macro, so it can be collected by gettext and added to a translation catalog. Your application can then use this catalog and serve out a translated version of the tip.")
+Translatable strings must strictly begin with _(", not _( " or wxGetTranslation(" or something else.
+If you are using gettext translatable strings, don't forget to escape to replace any " characters within the tip with a \" instead
+_("This is a translatable tip with the quoted words \"Escape me\" properly escaped.")
+If you have very specialized needs, you can derive your own wxTipProvider and use that instead.
+If you want to modify the tip content at runtime for purposes other than translation (for example, variable expansion), one easy option is to use a custom tip provider derived from wxFileTipProvider. Your custom tip provider would contain a single virtual function to override: PreprocessTip().

data/samples/etc/activation.rb

@@ -0,0 +1,108 @@
+#!/usr/bin/env ruby
+# wxRuby2 Sample Code. Copyright (c) 2004-2006 Kevin B. Smith
+# Freely reusable code: see SAMPLES-LICENSE.TXT for details
+
+begin
+  require 'wx'
+rescue LoadError => no_wx_err
+  begin
+    require 'rubygems'
+    require 'wx'
+  rescue LoadError
+    raise no_wx_err
+  end
+end
+
+# This sample demonstrates the use of Activate Events. These are
+# generated when a frame becomes active or inactive. This is typically
+# indicated by a frame's titlebar changing colour, and a widget within
+# the frame gainin focus. An event is also generated when a whole wxRuby
+# app starts or stops being the current focussed desktop application.
+
+class MinimalFrame < Wx::Frame
+  def initialize(title, pos, size, style = Wx::DEFAULT_FRAME_STYLE)
+    super(nil, -1, title, pos, size, style)
+
+
+    menuFile = Wx::Menu.new()
+    helpMenu = Wx::Menu.new()
+    helpMenu.append(Wx::ID_ABOUT, "&About...\tF1", "Show about dialog")
+    menuFile.append(Wx::ID_EXIT, "E&xit\tAlt-X", "Quit this program")
+    menuBar = Wx::MenuBar.new()
+    menuBar.append(menuFile, "&File")
+    menuBar.append(helpMenu, "&Help")
+    set_menu_bar(menuBar)
+
+    create_status_bar(2)
+    set_status_text("Welcome to wxRuby!")
+
+    evt_menu(Wx::ID_EXIT) { on_quit }
+    evt_menu(Wx::ID_ABOUT) { on_about }
+
+    evt_activate { | e | on_activate(e) }
+    evt_iconize  { | e | on_iconize(e) }
+  end
+
+
+  def on_iconize(event)
+    if event.iconized
+      puts "Frame '#{get_title}' was iconized"
+    else
+      puts "Frame '#{get_title}' was restored"
+    end
+  end
+
+  def on_activate(event)
+    if event.get_active
+      puts "Frame '#{get_title}' became activated"
+      set_status_text 'Active'
+    else
+      puts "Frame '#{get_title}' became deactivated"
+      set_status_text 'Inactive'
+    end
+    event.skip # important
+  end
+
+  def on_quit
+    Wx::get_app.close_all
+  end
+
+  def on_about
+    msg =  sprintf("This is the About dialog of the activate sample.\n" \
+                    "Welcome to wxRuby, version %s", Wx::WXRUBY_VERSION)
+    Wx::message_box(msg, "About Activate", Wx::OK|Wx::ICON_INFORMATION, self)
+  end
+end
+
+class RbApp < Wx::App
+  def on_init
+    @frame_1 = MinimalFrame.new("Tall window",
+                                Wx::Point.new(50, 50), 
+                                Wx::Size.new(150, 240))
+    @frame_2 = MinimalFrame.new("Wide window",
+                                Wx::Point.new(100, 100), 
+                                Wx::Size.new(300, 180))
+    evt_activate_app { | e | on_activate_app(e) }
+    @frame_1.show()
+    @frame_2.show()
+
+  end
+
+  def on_activate_app(event)
+    if event.get_active
+      puts "The app became active"
+    else
+      puts "The app became inactive"
+    end
+    event.skip # important
+  end
+
+  def close_all
+    @frame_1.close(true)
+    @frame_2.close(true)
+  end
+end
+
+app = RbApp.new
+app.main_loop()
+

data/samples/etc/choice.rb

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+# wxRuby2 Sample Code. Copyright (c) 2004-2006 Kevin B. Smith
+# Freely reusable code: see SAMPLES-LICENSE.TXT for details
+
+begin
+  require 'wx'
+rescue LoadError => no_wx_err
+  begin
+    require 'rubygems'
+    require 'wx'
+  rescue LoadError
+    raise no_wx_err
+  end
+end
+include Wx
+
+ID_CHOICE = 1000
+
+class ChoiceDlg < Dialog
+  def initialize
+    super(nil, -1, "ChoiceDialog", DEFAULT_POSITION, Size.new(185, 185))
+
+    list = [ "ABS", "Airbag", "Air conditioning" ]
+
+    @m_pChoice = Choice.new(self, ID_CHOICE, DEFAULT_POSITION, DEFAULT_SIZE, list)
+    @m_pChoice.append("Automatic gear", 100)
+
+	@m_pLabel = StaticText.new(self, -1, "default")
+    dlgSizer = BoxSizer.new(HORIZONTAL)
+    choiceSizer = BoxSizer.new(VERTICAL)
+    choiceSizer.add(@m_pChoice, 1, GROW)
+	choiceSizer.add(@m_pLabel)
+    dlgSizer.add(choiceSizer, 1, GROW)
+    set_sizer(dlgSizer)
+    set_auto_layout(TRUE)
+    layout()
+
+    evt_choice(ID_CHOICE) {|event| onChoice(event) }
+    evt_close {onClose}
+  end
+
+  def onChoice(event)
+  	chose = event.get_selection
+	data = event.get_client_data
+    # NOTE: uninitialized client data will be false, not nil
+	if(!data)
+		data = 0
+	end
+	data += 1
+	@m_pLabel.set_label(data.to_s)
+
+	@m_pChoice.set_selection(chose)
+	@m_pChoice.set_client_data(chose, data)
+  end
+
+  def onClose
+     destroy()
+  end
+end
+
+
+class RbApp < App
+  def on_init
+    dlg = ChoiceDlg.new
+    set_top_window(dlg)
+    dlg.show(TRUE)
+  end
+
+end
+
+a = RbApp.new
+a.main_loop()

data/samples/etc/miniframe.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/env ruby
+# wxRuby2 Sample Code. Copyright (c) 2004-2006 Kevin B. Smith
+# Freely reusable code: see SAMPLES-LICENSE.TXT for details
+
+begin
+  require 'wx'
+rescue LoadError => no_wx_err
+  begin
+    require 'rubygems'
+    require 'wx'
+  rescue LoadError
+    raise no_wx_err
+  end
+end
+
+class MyFrame < Wx::Frame
+  attr_reader :mini
+
+  def initialize(title, pos, size, style = Wx::DEFAULT_FRAME_STYLE)
+    super(nil, -1, title, pos, size, style)
+
+
+    menuFile = Wx::Menu.new()
+    helpMenu = Wx::Menu.new()
+    helpMenu.append(Wx::ID_ABOUT, "&About...\tF1", "Show about dialog")
+    menuFile.append(Wx::ID_EXIT, "E&xit\tAlt-X", "Quit this program")
+    menuBar = Wx::MenuBar.new()
+    menuBar.append(menuFile, "&File")
+    menuBar.append(helpMenu, "&Help")
+    set_menu_bar(menuBar)
+
+    create_status_bar(2)
+    set_status_text("Welcome to wxRuby!")
+
+    evt_menu(Wx::ID_EXIT) { on_quit }
+    evt_menu(Wx::ID_ABOUT) { on_about }
+
+    make_miniframe()
+  end
+
+  def make_miniframe
+    @mini = Wx::MiniFrame.new(self, -1, 'Mini Frame', 
+                              Wx::Point.new(300, 75), Wx::Size.new(300, 150),
+                              Wx::DEFAULT_FRAME_STYLE|Wx::STAY_ON_TOP)
+    sizer = Wx::BoxSizer.new(Wx::VERTICAL)
+    text = Wx::StaticText.new(mini, -1, 'This is a MiniFrame.')
+    sizer.add(text, 0, Wx::ALL, 2)
+    text = Wx::StaticText.new(mini, -1, 'It has a small title bar so it')
+    sizer.add(text, 0, Wx::ALL, 2)
+    text = Wx::StaticText.new(mini, -1, 'doesn\'t take up too much space.')
+    sizer.add(text, 0, Wx::ALL, 2)
+    text = Wx::StaticText.new(mini, -1, 'This MiniFrame has been set to')
+    sizer.add(text, 0, Wx::ALL, 2)
+    text = Wx::StaticText.new(mini, -1, 'stay above the main app window.')
+    sizer.add(text, 0, Wx::ALL, 2)
+    mini.set_sizer(sizer)
+    mini.show()
+    mini.raise()
+  end
+
+  def on_quit
+    mini.close()
+    close()
+  end
+
+  def on_about
+    msg =  sprintf("This is the About dialog of the miniframe sample.\n" \
+                    "Welcome to %s", Wx::VERSION_STRING)
+    Wx::message_box(msg, "About MiniFrame", Wx::OK|Wx::ICON_INFORMATION, self)
+  end
+end
+
+class RbApp < Wx::App
+  def on_init
+    frame = MyFrame.new("Mini Frame wxRuby App",
+                        Wx::Point.new(50, 50), 
+                        Wx::Size.new(450, 340))
+    frame.show()
+  end
+end
+
+app = RbApp.new
+app.main_loop()
+

data/samples/etc/sash.rb

@@ -0,0 +1,135 @@
+#!/usr/bin/env ruby
+# wxRuby2 Sample Code. Copyright (c) 2004-2006 Kevin B. Smith
+# Freely reusable code: see SAMPLES-LICENSE.TXT for details
+
+begin
+  require 'wx'
+rescue LoadError => no_wx_err
+  begin
+    require 'rubygems'
+    require 'wx'
+  rescue LoadError
+    raise no_wx_err
+  end
+end
+
+class MySashFrame < Wx::Frame
+  def initialize(title, pos, size, style = Wx::DEFAULT_FRAME_STYLE)
+    super(nil, -1, title, pos, size, style)
+
+
+    menuFile = Wx::Menu.new()
+    helpMenu = Wx::Menu.new()
+    helpMenu.append(Wx::ID_ABOUT, "&About...\tF1", "Show about dialog")
+    menuFile.append(Wx::ID_EXIT, "E&xit\tAlt-X", "Quit this program")
+    menuBar = Wx::MenuBar.new()
+    menuBar.append(menuFile, "&File")
+    menuBar.append(helpMenu, "&Help")
+    set_menu_bar(menuBar)
+
+    create_status_bar(2)
+    set_status_text("wxRuby Sash sample")
+
+    evt_menu(Wx::ID_EXIT) { on_quit }
+    evt_menu(Wx::ID_ABOUT) { on_about }
+
+    # Start creating the sashes - these are created from outermost
+    # inwards. 
+    sash = Wx::SashLayoutWindow.new(self, -1, Wx::DEFAULT_POSITION,
+                                    Wx::Size.new(150, self.get_size.y) )
+    # The default width of the sash is 150 pixels, and it extends the
+    # full height of the frame
+    sash.set_default_size( Wx::Size.new(150, self.get_size.y) )
+    # This sash splits the frame top to bottom
+    sash.set_orientation(Wx::LAYOUT_VERTICAL)
+    # Place the sash on the left of the frame
+    sash.set_alignment(Wx::LAYOUT_LEFT)
+    # Show a drag bar on the right of the sash
+    sash.set_sash_visible(Wx::SASH_RIGHT, true)
+    sash.set_background_colour(Wx::Colour.new(225, 200, 200) )
+
+    panel = Wx::Panel.new(sash)
+    v_siz = Wx::BoxSizer.new(Wx::VERTICAL)
+    chk_1 = Wx::CheckBox.new(panel, -1, 'test 1')
+    v_siz.add(chk_1, 0, Wx::ADJUST_MINSIZE)
+    chk_2 = Wx::CheckBox.new(panel, -1, 'test 2')
+    v_siz.add(chk_2, 0, Wx::ADJUST_MINSIZE)
+    panel.set_sizer_and_fit(v_siz)
+
+    # handle the sash being dragged
+    evt_sash_dragged( sash.get_id ) { | e | on_v_sash_dragged(sash, e) }
+
+    # Create another small sash on the bottom of the frame
+    sash_2 = Wx::SashLayoutWindow.new(self, -1, Wx::DEFAULT_POSITION,
+                                      Wx::Size.new(self.get_size.x,
+                                      100),
+                                      Wx::SW_3DSASH)
+    sash_2.set_default_size( Wx::Size.new(self.get_size.x, 100) )
+    sash_2.set_orientation(Wx::LAYOUT_HORIZONTAL)
+    sash_2.set_alignment(Wx::LAYOUT_BOTTOM)
+    sash_2.set_sash_visible(Wx::SASH_TOP, true)
+    text = Wx::StaticText.new(sash_2, -1, 'This is the second sash window')
+    evt_sash_dragged( sash_2.get_id ) { | e | on_h_sash_dragged(sash_2, e) }
+
+    # The main panel - the residual part of the frame that takes up all
+    # remaining space not used by the sash windows.
+    @m_panel = Wx::Panel.new(self, -1)
+    sizer = Wx::BoxSizer.new(Wx::VERTICAL)
+
+    txt  = Wx::TextCtrl.new(@m_panel, -1, 'Main panel area', 
+                            Wx::DEFAULT_POSITION, Wx::DEFAULT_SIZE,
+                            Wx::SUNKEN_BORDER|Wx::TE_MULTILINE)
+    sizer.add(txt, 1, Wx::EXPAND|Wx::ADJUST_MINSIZE|Wx::ALL, 10)
+    @m_panel.set_sizer_and_fit(sizer)
+
+    # Adjust the size of the sashes when the frame is resized
+    evt_size { | e | on_size(e) }
+
+    # Call LayoutAlgorithm#layout_frame to layout the sashes.
+    # The second argument is the residual window that takes up remaining
+    # space
+    Wx::LayoutAlgorithm.new.layout_frame(self, @m_panel)
+  end
+
+  def on_v_sash_dragged(sash, e)
+    # Call get_drag_rect to get the new size
+    size = Wx::Size.new(  e.get_drag_rect.width(), self.get_size.y )
+    sash.set_default_size( size )
+    Wx::LayoutAlgorithm.new.layout_frame(self, @m_panel)
+  end
+
+  def on_h_sash_dragged(sash, e)
+    size = Wx::Size.new( self.get_size.x, e.get_drag_rect.height() )
+    sash.set_default_size( size )
+    Wx::LayoutAlgorithm.new.layout_frame(self, @m_panel)
+  end
+
+  def on_size(e)
+    e.skip()
+    Wx::LayoutAlgorithm.new.layout_frame(self, @m_panel)
+  end
+
+  def on_quit
+    close(true)
+  end
+
+  def on_about
+    msg =  sprintf("This is the About dialog of the sash sample.\n" \
+                    "Welcome to %s", Wx::VERSION_STRING)
+    Wx::message_box(msg, "About Sash", Wx::OK|Wx::ICON_INFORMATION, self)
+  end
+end
+
+class SashApp < Wx::App
+  def on_init
+    frame = MySashFrame.new("Sash Layout wxRuby App",
+                            Wx::Point.new(50, 50), 
+                            Wx::Size.new(450, 340))
+
+    frame.show(true)
+
+  end
+end
+
+app = SashApp.new
+app.main_loop()

data/samples/etc/scrollwin.rb

@@ -0,0 +1,116 @@
+#!/usr/bin/env ruby
+# wxRuby2 Sample Code. Copyright (c) 2004-2006 Kevin B. Smith
+# Freely reusable code: see SAMPLES-LICENSE.TXT for details
+
+begin
+  require 'wx'
+rescue LoadError => no_wx_err
+  begin
+    require 'rubygems'
+    require 'wx'
+  rescue LoadError
+    raise no_wx_err
+  end
+end
+
+# Example demonstrating the use of Wx::ScrolledWindow and the
+# ScrollWinEvents
+
+class ScrollFrame < Wx::Frame
+  def initialize(title)
+    super(nil, -1, 'Thumb Scrolling Test', 
+          Wx::DEFAULT_POSITION, Wx::Size.new(400, 300), 
+          Wx::SYSTEM_MENU|Wx::CAPTION|Wx::RESIZE_BORDER|
+                          Wx::MAXIMIZE_BOX|Wx::MINIMIZE_BOX|Wx::CLOSE_BOX)
+
+    @scroll_win = Wx::ScrolledWindow.new(self, -1)
+    # Set the interior size (pixels) of the scrolling window
+    @scroll_win.set_virtual_size(1000, 1500)
+    # Set the number of pixels moved per 'line' / click on the scrollbars
+    @scroll_win.set_scroll_rate(5, 5)
+
+    @button = Wx::Button.new(@scroll_win, -1, 'Press Me', 
+                             Wx::Point.new(200,200), 
+                             Wx::Size.new(125, 20))
+    
+    # NOTE that all ScrollWin event hooks do not take an id - i.e. they
+    # are only generated from the originating Window itself - in this
+    # case, the ScrollWindow. So, we need to do:
+    #  @scroll_win.evt_scrollwin_xxx { ...
+    # AND NOT
+    #  evt_scrollwin_xxx(@scroll_win.get_id) { ...
+    @scroll_win.evt_scrollwin_linedown() { | e | on_line(e, 'down') }
+    @scroll_win.evt_scrollwin_lineup() { | e | on_line(e,'up') }
+    
+    @scroll_win.evt_scrollwin_thumbtrack() { | e | on_thumb(e, 'track') }
+    @scroll_win.evt_scrollwin_thumbrelease() { | e | on_thumb(e, 'release') }
+
+    @scroll_win.evt_scrollwin_pagedown() { | e | on_page(e, 'down') }
+    @scroll_win.evt_scrollwin_pageup() { | e | on_page(e, 'up') }
+
+    # not sure how these are meant to be generated
+    @scroll_win.evt_scrollwin_top() { | e | on_top(e) }
+    @scroll_win.evt_scrollwin_bottom() { | e | on_bottom(e) }
+    @scroll_win.evt_scrollwin { | e | p e }
+  end
+  
+  # Handle scrolling by page - typically done by clicking on the
+  # scrollbar itself, above or below the thumb position
+  # +direction+ is either 'up' (= left, if dealing with a horizontal
+  # scrollbar) or 'down' (= right) - WxRuby generates different events
+  # for these.
+  def on_page(event, direction)
+    pos = event.get_position
+    orient = event.get_orientation == Wx::VERTICAL ? 'VERTICAL' : 'HORIZONTAL'
+    puts "#{orient} scrollbar page #{direction} @ #{pos}"
+    event.skip() # allow default scrolling action
+  end
+
+  
+  # Handle scrolling by line - typically done by clicking the up/down
+  # (or left/right) scroll buttons at the end of the scrollbar.
+  # +direction+ is either 'up' (= left, if dealing with a horizontal
+  # scrollbar) or 'down' (= right)
+  def on_line(event, direction)
+    orient = event.get_orientation == Wx::VERTICAL ? 'VERTICAL' : 'HORIZONTAL'
+    pos = event.get_position
+    puts "#{orient} scrollbar line #{direction} @ #{pos}"
+    event.skip() # allow default action
+  end
+
+  # Handle scrolling done by click-dragging the 'thumb' within a scrollbar.
+  # +action+ contains either 'track' for thumbtrack drag events, or 'release'
+  # for thumb-release
+  def on_thumb(event, action)
+    pos = event.get_position
+    if event.get_orientation == Wx::VERTICAL
+      puts "VERTICAL thumb #{action} @ #{pos}"
+    else
+      puts "HORIZONTAL thumb #{action} @ #{pos}"
+    end
+    event.skip()
+  end
+
+  # (Assuming this should be triggered when the End key is pressed)?
+  def on_bottom(event)
+    puts "bottom"
+  end
+  
+
+  #  (Assuming this should be triggered when the Home/Begin key is pressed)?
+  def on_top(event)
+    puts "top"
+  end
+
+end
+
+class ScrollingApp < Wx::App
+  def on_init
+    frame = ScrollFrame.new('')
+    frame.show(TRUE)
+  end
+end
+
+app = ScrollingApp.new
+app.main_loop()
+