rndk 0.2.0 → 1.0.0

data/examples/scroll.rb

@@ -14,11 +14,11 @@ require 'rndk/scroll'
 
 begin
   # Set up RNDK and colors
-  rndkscreen = RNDK::Screen.new
+  screen = RNDK::Screen.new
   RNDK::Color.init
 
   # Turning off the blinking cursor
-  Ncurses.curs_set 0
+  RNDK::blink_cursor false
 
   # Use the current directory list to fill the radio list
   item = RNDK.get_directory_contents '.'
@@ -29,73 +29,29 @@ begin
   # See example 'markup.rb' for more details.
   title = <<END
 <C></77>Pick a file
-</77>Press 'a' to append an item
-</77>Press 'i' to insert an item
-</77>Press 'd' to delete current item
-</77>(don't worry, won't delete your files)
 </77>Press 'enter' or 'tab' to select item
 ------------------------------------------------
 END
 
   # Create the scrolling list.
-  scroll_list = RNDK::Scroll.new(rndkscreen,
-                                 RNDK::CENTER,      # x
-                                 RNDK::CENTER,      # y
-                                 RNDK::RIGHT,       # scrollbar position
-                                 50,                # width
-                                 24,                # height
-                                 title,             # title
-                                 item,              # items on the list
-                                 true,              # show numbers
-                                 RNDK::Color[:red], # highlight color
-                                 true,              # box
-                                 false)             # shadow
+  scroll_list = RNDK::Scroll.new(screen, {
+                                   :x => RNDK::CENTER,
+                                   :y => RNDK::CENTER,
+                                   :width => 50,
+                                   :height => 24,
+                                   :title => title,
+                                   :items => item,
+                                   :numbers => true,
+                                   :highlight => RNDK::Color[:red]
+                                 })
 
   if scroll_list.nil?
-    RNDK::Screen.end_rndk
+    RNDK::Screen.finish
 
     puts "Cannot make scrolling list.  Is the window too small?"
     exit 1
   end
 
-  # These are the functions that will modify the
-  # Scroll List at runtime.
-  #
-  # The arguments to the block are provided by
-  # default, you can ignore them right now.
-  #
-  # The only thing you need to know is that `widget` is
-  # the scroll - widget that we attach the callback to.
-  $counter = 0
-
-  add_item_callback = lambda do |type, widget, client_data, input|
-    widget.addItem "add_#{$counter}"
-    $counter += 1
-    widget.screen.refresh
-    return true
-  end
-
-  insert_item_callback = lambda do |type, widget, client_data, input|
-    widget.insertItem "insert_#{$counter}"
-    $counter += 1
-    widget.screen.refresh
-    return true
-  end
-
-  delete_item_callback = lambda do |type, widget, client_data, input|
-    widget.deleteItem widget.getCurrentItem
-    widget.screen.refresh
-    return true
-  end
-
-  # And this is how we bind keys to actions.
-  #
-  # It only accepts lambdas.
-
-  scroll_list.bind(:scroll, 'a', add_item_callback, nil)
-  scroll_list.bind(:scroll, 'i', insert_item_callback, nil)
-  scroll_list.bind(:scroll, 'd', delete_item_callback, nil)
-
   # Activate the scrolling list.
   selection = scroll_list.activate
 
@@ -116,13 +72,13 @@ END
   end
 
   # A quick widget - see example 'quick-widgets.rb'
-  rndkscreen.popup_label msg
+  screen.popup_label msg
 
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
 # Just in case something bad happens.
 rescue Exception => e
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
   puts e
   puts e.inspect

data/examples/slider.rb

@@ -10,27 +10,26 @@ begin
   label = '</B>Current Value:'
 
   # Set up RNDK
-  rndkscreen = RNDK::Screen.new
+  screen = RNDK::Screen.new
   RNDK::Color.init
 
   # Create the widget
-  widget = RNDK::Slider.new(rndkscreen,
-                            RNDK::CENTER,
-                            RNDK::CENTER,
-                            title,
-                            label,
-                            Ncurses::A_REVERSE | RNDK::Color[:white_blue] | ' '.ord,
-                            50,
-                            1,
-                            1,
-                            100,
-                            1,
-                            2,
-                            true,
-                            false)
+  widget = RNDK::Slider.new(screen, {
+                              :x => RNDK::CENTER,
+                              :y => RNDK::CENTER,
+                              :title => title,
+                              :label => label,
+                              :filler => RNDK::Color[:reverse] | RNDK::Color[:white_blue] | ' '.ord,
+                              :field_width => 50,
+                              :start => 50,
+                              :mininum => 1,
+                              :maximum => 100,
+                              :increment => 1,
+                              :fast_increment => 2
+                            })
 
   if widget.nil?
-    RNDK::Screen.end_rndk
+    RNDK::Screen.finish
 
     puts "Cannot make the widget. Is the window too small?"
     exit 1
@@ -53,14 +52,14 @@ begin
 
   # A quick popup widget! Check out the
   # example file 'quick-widgets.rb'
-  rndkscreen.popup_label mesg
+  screen.popup_label mesg
 
   # Clean up
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
 # Just in case something bad happens.
 rescue Exception => e
-  RNDK::Screen.end_rndk
+  RNDK::Screen.finish
 
   puts e
   puts e.inspect

data/examples/viewer.rb

@@ -0,0 +1,65 @@
+#!/usr/bin/env ruby
+#
+# Shows the content of this file with the Viewer widget.
+# See file `lib/rndk/viewer.rb` for keybindings.
+#
+require 'rndk/viewer'
+
+begin
+  screen = RNDK::Screen.new
+  RNDK::Color.init
+
+  # Oh yeah, gimme this file
+  lines = RNDK.read_file(__FILE__)
+  buttons = ["These", "Don't", "do", "a", "thing"]
+
+  viewer = RNDK::Viewer.new(screen, {
+                              :x => RNDK::CENTER,
+                              :y => RNDK::CENTER,
+                              :title => "</77>Awesome Viewer",
+                              :buttons => buttons,
+                              :button_highlight => RNDK::Color[:white_red],
+                              :shadow => true
+                            })
+
+  # To set the lines of Viewer we must use Viewer#set.
+  # No way to do it on the constructor :(
+  viewer.set :items => lines
+
+  if viewer.nil?
+    RNDK::Screen.finish
+
+    puts "Cannot create the viewer. Is the window too small?"
+    exit 1
+  end
+
+  selected = viewer.activate
+
+  # Check how the person exited from the widget.
+  mesg = []
+
+  if viewer.exit_type == :ESCAPE_HIT
+    mesg = ["<C>Escape hit. No Button selected..",
+            "",
+            "<C>Press any key to continue."]
+
+  elsif viewer.exit_type == :NORMAL
+    mesg = ["<C>You selected button #{selected}",
+            "<C>Press any key to continue."]
+
+  end
+  # Quickly show message
+  screen.popup_label mesg
+
+  RNDK::Screen.finish
+
+  # Just in case something bad happens.
+rescue Exception => e
+  RNDK::Screen.finish
+
+  puts e
+  puts e.inspect
+  puts e.backtrace
+  exit 1
+end
+

data/lib/rndk.rb

@@ -19,8 +19,13 @@
 #   page with `man lowercase_function_name`.
 #
 require 'ffi-ncurses'
-require 'scanf'
 
+# Shortcut to avoid typing FFI::NCurses all the time.
+# You can use it too!
+# It MUST come before `require 'rndk/core/draw'`
+Ncurses = FFI::NCurses
+
+require 'scanf'
 require 'rndk/core/draw'
 require 'rndk/core/color'
 require 'rndk/core/display'
@@ -30,9 +35,6 @@ require 'rndk/core/screen'
 require 'rndk/core/markup'
 require 'rndk/core/utils'
 
-# Shortcut to avoid typing FFI::NCurses all the time.
-# You can use it too!
-Ncurses = FFI::NCurses
 
 module RNDK
 
@@ -58,7 +60,7 @@ module RNDK
 
   MAX_BINDINGS = 300
   MAX_ITEMS    = 2000
-  MAX_BUTTONS  = 200
+  MAX_ButtonS  = 200
 
   # Key value when pressing Ctrl+`char`.
   def RNDK.CTRL(char)
@@ -69,6 +71,7 @@ module RNDK
   # for Widget interaction.
   #
   # Example:  `RNDK.CTRL('L')` is `Ctrl+L` or `C-l`
+
   REFRESH    = RNDK.CTRL('L')
   PASTE      = RNDK.CTRL('V')
   COPY       = RNDK.CTRL('Y')
@@ -86,8 +89,11 @@ module RNDK
   KEY_RETURN = "\012".ord
   KEY_TAB    = "\t".ord
 
+  # All the screens eventually created.
   ALL_SCREENS = []
-  ALL_OBJECTS = []
+
+  # All the widgets eventually created.
+  ALL_WIDGETS = []
 
   # Beeps then flushes the stdout stream.
   #
@@ -116,7 +122,8 @@ module RNDK
     (character >= 0) and (character < Ncurses::KEY_MIN)
   end
 
-  # Returns the function keys - F1, F2 ... F12 ...
+  # Returns internal Ncurses' function keys values
+  # (F1, F2 ... F12 ...)
   def RNDK.KEY_F(n)
     264 + n
   end
@@ -148,6 +155,7 @@ module RNDK
 
     RNDK.window_erase window
     Ncurses.delwin window
+    window = nil
   end
 
   # Safely moves a raw Ncurses window.
@@ -230,5 +238,18 @@ module RNDK
     end
   end
 
+  # Sets on/off the blinking cursor.
+  # @return The cursor's previous state.
+  def RNDK.blink_cursor option
+    ret = false
+    if option
+      ret = Ncurses.curs_set 1
+    else
+      ret = Ncurses.curs_set 0
+    end
+
+    if ret == 1 then true else false end
+  end
+
 end
 

data/lib/rndk/alphalist.rb

@@ -2,28 +2,29 @@ require 'rndk'
 
 module RNDK
 
-  # Allows user to select from a list of alphabetically sorted words.
+  # Allows user to select from a items of alphabetically sorted
+  # words.
   #
-  # Use the arrow keys to navigate on the list or type in the
+  # Use the arrow keys to navigate on the items or type in the
   # beginning of the word and it'll automagically adjust
   # itself in the correct place.
   #
   # ## Keybindings
   #
-  # Since Alphalist is built from both the Scroll and Entry Widgets,
+  # Since Alphaitems is built from both the Scroll and Entry Widgets,
   # the key bindings are the same for the respective fields.
   #
-  # Extra key bindings are listed below:
+  # Extra key bindings are itemsed below:
   #
-  # Up Arrow::   Scrolls the scrolling list up one line.
-  # Down Arrow:: Scrolls the scrolling list down one line.
-  # Page Up::    Scrolls the scrolling list up one page.
-  # CTRL-B::     Scrolls the scrolling list up one page.
-  # Page Down::  Scrolls the scrolling list down one page.
-  # CTRL-F::     Scrolls the scrolling list down one page.
+  # Up Arrow::   Scrolls the scrolling items up one line.
+  # Down Arrow:: Scrolls the scrolling items down one line.
+  # Page Up::    Scrolls the scrolling items up one page.
+  # CTRL-B::     Scrolls the scrolling items up one page.
+  # Page Down::  Scrolls the scrolling items down one page.
+  # CTRL-F::     Scrolls the scrolling items down one page.
   # Tab::        Tries to complete the word in the entry field.
   #              If the word segment is not unique then the widget
-  #              will beep  and  present  a list of close matches.
+  #              will beep  and  present  a items of close matches.
   # Return::     Returns the word in the entry field.
   #              It  also  sets  the widget data exitType to `:NORMAL`.
   # Escape::     Exits the widget and returns `nil`.
@@ -32,28 +33,30 @@ module RNDK
   # ## Developer notes
   #
   # This widget, like the file selector widget, is a compound widget
-  # of both the entry field widget and the scrolling list widget - sorted.
+  # of both the entry field widget and the scrolling items widget - sorted.
+  #
+  # @todo Kinda buggy, fix first words, mate
   #
   class Alphalist < Widget
-    attr_reader :scroll_field, :entry_field, :list
+    attr_reader :scroll_field, :entry_field, :items
 
     # Creates an Alphalist Widget.
     #
-    # * `xplace` is the x position - can be an integer or `RNDK::LEFT`,
+    # ## Settings
+    #
+    # * `x` is the x position - can be an integer or `RNDK::LEFT`,
     #   `RNDK::RIGHT`, `RNDK::CENTER`.
-    # * `yplace` is the y position - can be an integer or `RNDK::TOP`,
+    # * `y` is the y position - can be an integer or `RNDK::TOP`,
     #   `RNDK::BOTTOM`, `RNDK::CENTER`.
     # * `width`/`height` are integers - if either are 0, Widget
     #   will be created with full width/height of the screen.
     #   If it's a negative value, will create with full width/height
     #   minus the value.
-    # * `message` is an Array of Strings with all the lines you'd want
-    #   to show. RNDK markup applies (see RNDK#Markup).
     # * `title` can be more than one line - just split them
     #   with `\n`s.
     # * `label` is the String that will appear on the label
     #   of the Entry field.
-    # * `list` is an Array of Strings with the content to
+    # * `items` is an Array of Strings with the content to
     #   display.
     # * `filler_char` is the character to display on the
     #   empty spaces in the Entry field.
@@ -62,34 +65,49 @@ module RNDK
     # * `box` if the Widget is drawn with a box outside it.
     # * `shadow` turns on/off the shadow around the Widget.
     #
-    def initialize(rndkscreen,
-                   xplace,
-                   yplace,
-                   width,
-                   height,
-                   title,
-                   label,
-                   list,
-                   filler_char,
-                   highlight,
-                   box,
-                   shadow)
+    def initialize(screen, config={})
       super()
+      @widget_type  = :alphaitems
+      @supported_signals += [:before_input, :after_input]
+
+      # This is UGLY AS HELL
+      # But I don't have time to clean this up right now
+      # (lots of widgets, you know)  :(
+      x           = 0
+      y           = 0
+      width       = 0
+      height      = 0
+      title       = "alphaitems"
+      label       = "label"
+      items        = []
+      filler_char = '.'
+      highlight   = RNDK::Color[:reverse]
+      box         = true
+      shadow      = false
+
+      config.each do |key, val|
+        x           = val if key == :x
+        y           = val if key == :y
+        width       = val if key == :width
+        height      = val if key == :height
+        title       = val if key == :title
+        label       = val if key == :label
+        items        = val if key == :items
+        filler_char = val if key == :filler_char
+        highlight   = val if key == :highlight
+        box         = val if key == :box
+        shadow      = val if key == :shadow
+      end
 
-      parent_width  = Ncurses.getmaxx rndkscreen.window
-      parent_height = Ncurses.getmaxy rndkscreen.window
+      parent_width  = Ncurses.getmaxx screen.window
+      parent_height = Ncurses.getmaxy screen.window
 
       box_width  = width
       box_height = height
 
       label_len = 0
 
-      bindings = {
-        RNDK::BACKCHAR => Ncurses::KEY_PPAGE,
-        RNDK::FORCHAR  => Ncurses::KEY_NPAGE,
-      }
-
-      if not self.createList list
+      if not self.create_items items
         self.destroy
         return nil
       end
@@ -98,11 +116,11 @@ module RNDK
 
       # If the height is a negative value, the height will be ROWS-height,
       # otherwise the height will be the given height.
-      box_height = RNDK.setWidgetDimension(parent_height, height, 0)
+      box_height = RNDK.set_widget_dimension(parent_height, height, 0)
 
       # If the width is a negative value, the width will be COLS-width,
       # otherwise the width will be the given width.
-      box_width = RNDK.setWidgetDimension(parent_width, width, 0)
+      box_width = RNDK.set_widget_dimension(parent_width, width, 0)
 
       # Translate the label string to a chtype array
       if label.size > 0
@@ -112,9 +130,9 @@ module RNDK
       end
 
       # Rejustify the x and y positions if we need to.
-      xtmp = [xplace]
-      ytmp = [yplace]
-      RNDK.alignxy(rndkscreen.window, xtmp, ytmp, box_width, box_height)
+      xtmp = [x]
+      ytmp = [y]
+      RNDK.alignxy(screen.window, xtmp, ytmp, box_width, box_height)
       xpos = xtmp[0]
       ypos = ytmp[0]
 
@@ -127,8 +145,8 @@ module RNDK
       end
       Ncurses.keypad(@win, true)
 
-      @screen = rndkscreen
-      @parent = rndkscreen.window
+      @screen = screen
+      @parent = screen.window
       @highlight   = highlight
       @filler_char = filler_char
 
@@ -149,19 +167,15 @@ module RNDK
                     else box_width - 2 - label_len
                     end
 
-      @entry_field = RNDK::Entry.new(rndkscreen,
-                                     Ncurses.getbegx(@win),
-                                     Ncurses.getbegy(@win),
-                                     title,
-                                     label,
-                                     Ncurses::A_NORMAL,
-                                     filler_char,
-                                     :MIXED,
-                                     temp_width,
-                                     0,
-                                     512,
-                                     box,
-                                     false)
+      @entry_field = RNDK::Entry.new(screen, {
+                                       :x => Ncurses.getbegx(@win),
+                                       :y => Ncurses.getbegy(@win),
+                                       :title => title,
+                                       :label => label,
+                                       :filler => filler_char,
+                                       :field_width => temp_width,
+                                       :box => box
+                                     })
       if @entry_field.nil?
         self.destroy
         return nil
@@ -169,191 +183,16 @@ module RNDK
       @entry_field.setLLchar Ncurses::ACS_LTEE
       @entry_field.setLRchar Ncurses::ACS_RTEE
 
-      # Callback functions
-      adjust_alphalist_cb = lambda do |object_type, object, alphalist, key|
-        scrollp = alphalist.scroll_field
-        entry   = alphalist.entry_field
-
-        if scrollp.list_size > 0
-          # Adjust the scrolling list.
-          alphalist.injectMyScroller(key)
-
-          # Set the value in the entry field.
-          current = RNDK.chtype2Char scrollp.item[scrollp.current_item]
-          entry.setValue current
-          entry.draw entry.box
-          return true
-        end
-
-        RNDK.beep
-        false
-      end
-
-      complete_word_cb = lambda do |object_type, object, alphalist, key|
-        entry = alphalist.entry_field
-        scrollp = nil
-        selected = -1
-        ret = 0
-        alt_words = []
-
-        if entry.info.size == 0
-          RNDK.beep
-          return true
-        end
-
-        # Look for a unique word match.
-        index = RNDK.searchList(alphalist.list, alphalist.list.size, entry.info)
-
-        # if the index is less than zero, return we didn't find a match
-        if index < 0
-          RNDK.beep
-          return true
-        end
-
-        # Did we find the last word in the list?
-        if index == alphalist.list.size - 1
-          entry.setValue alphalist.list[index]
-          entry.draw entry.box
-          return true
-        end
-
-        # Ok, we found a match, is the next item similar?
-        len = [entry.info.size, alphalist.list[index + 1].size].min
-        ret = alphalist.list[index + 1][0...len] <=> entry.info
-        if ret == 0
-          current_index = index
-          match = 0
-          selected = -1
-
-          # Start looking for alternate words
-          # FIXME(original): bsearch would be more suitable.
-          while (current_index < alphalist.list.size) and
-              ((alphalist.list[current_index][0...len] <=> entry.info) == 0)
-            alt_words << alphalist.list[current_index]
-            current_index += 1
-          end
-
-          # Determine the height of the scrolling list.
-          height = if alt_words.size < 8 then alt_words.size + 3 else 11 end
-
-          # Create a scrolling list of close matches.
-          scrollp = RNDK::Scroll.new(entry.screen,
-                                     RNDK::CENTER,
-                                     RNDK::CENTER,
-                                     RNDK::RIGHT,
-                                     height,
-                                     -30,
-                                     "<C></B/5>Possible Matches.",
-                                     alt_words,
-                                     true,
-                                     Ncurses::A_REVERSE,
-                                     true,
-                                     false)
-
-          # Allow them to select a close match.
-          match = scrollp.activate
-          selected = scrollp.current_item
-
-          # Check how they exited the list.
-          if scrollp.exit_type == :ESCAPE_HIT
-            # Destroy the scrolling list.
-            scrollp.destroy
-
-            RNDK.beep
-
-            # Redraw the alphalist and return.
-            alphalist.draw(alphalist.box)
-            return true
-          end
-
-          # Destroy the scrolling list.
-          scrollp.destroy
-
-          # Set the entry field to the selected value.
-          entry.set(alt_words[match], entry.min, entry.max, entry.box)
-
-          # Move the highlight bar down to the selected value.
-          (0...selected).each do |x|
-            alphalist.injectMyScroller(Ncurses::KEY_DOWN)
-          end
-
-          # Redraw the alphalist.
-          alphalist.draw alphalist.box
-
-        else
-          # Set the entry field with the found item.
-          entry.set(alphalist.list[index], entry.min, entry.max, entry.box)
-          entry.draw entry.box
-        end
-        true
-      end
-
-      pre_process_entry_field = lambda do |rndktype, object, alphalist, input|
-        scrollp = alphalist.scroll_field
-        entry = alphalist.entry_field
-        info_len = entry.info.size
-        result = 1
-        empty = false
-
-        if alphalist.isBind(:alphalist, input)
-          result = 1  # Don't try to use this key in editing
-
-        elsif (RNDK.is_char?(input) &&
-            input.chr.match(/^[[:alnum:][:punct:]]$/)) ||
-            [Ncurses::KEY_BACKSPACE, Ncurses::KEY_DC].include?(input)
-
-          index = 0
-          curr_pos = entry.screen_col + entry.left_char
-          pattern = entry.info.clone
-
-          if [Ncurses::KEY_BACKSPACE, Ncurses::KEY_DC].include? input
-
-            curr_pos -= 1 if input == Ncurses::KEY_BACKSPACE
-
-            pattern.slice!(curr_pos) if curr_pos >= 0
-
-          else
-            front   = (pattern[0...curr_pos] or '')
-            back    = (pattern[curr_pos..-1] or '')
-            pattern = front + input.chr + back
-          end
-
-          if pattern.size == 0
-            empty = true
-
-          elsif (index = RNDK.searchList(alphalist.list,
-                                         alphalist.list.size,
-                                         pattern)) >= 0
-
-            # XXX: original uses n scroll downs/ups for <10 positions change
-              scrollp.setPosition(index)
-            alphalist.drawMyScroller
-
-          else
-            RNDK.beep
-            result = 0
-          end
-        end
-
-        if empty
-          scrollp.setPosition(0)
-          alphalist.drawMyScroller
-        end
-
-        result
-      end
-
       # Set the key bindings for the entry field.
-      @entry_field.bind(:entry, Ncurses::KEY_UP,    adjust_alphalist_cb, self)
-      @entry_field.bind(:entry, Ncurses::KEY_DOWN,  adjust_alphalist_cb, self)
-      @entry_field.bind(:entry, Ncurses::KEY_NPAGE, adjust_alphalist_cb, self)
-      @entry_field.bind(:entry, Ncurses::KEY_PPAGE, adjust_alphalist_cb, self)
-      @entry_field.bind(:entry, RNDK::KEY_TAB,      complete_word_cb,    self)
+      @entry_field.bind_key(Ncurses::KEY_UP)    { self.autocomplete }
+      @entry_field.bind_key(RNDK::KEY_TAB)      { self.autocomplete }
+      @entry_field.bind_key(Ncurses::KEY_DOWN)  { self.adjust_items }
+      @entry_field.bind_key(Ncurses::KEY_NPAGE) { self.adjust_items }
+      @entry_field.bind_key(Ncurses::KEY_PPAGE) { self.adjust_items }
 
-      # Set up the post-process function for the entry field.
-      @entry_field.setPreProcess(pre_process_entry_field, self)
+      @entry_field.bind_signal(:before_input) { |char| self.pre_process_entry_field(char) }
 
-      # Create the scrolling list.  It overlaps the entry field by one line if
+      # Create the scrolling items.  It overlaps the entry field by one line if
       # we are using box-borders.
       temp_height = Ncurses.getmaxy(@entry_field.win) - @border_size
       temp_width = if Alphalist.isFullWidth(width)
@@ -361,33 +200,25 @@ module RNDK
                    else box_width - 1
                    end
 
-      @scroll_field = RNDK::Scroll.new(rndkscreen,
-                                      Ncurses.getbegx(@win),
-                                      Ncurses.getbegy(@entry_field.win) + temp_height,
-                                      RNDK::RIGHT,
-                                      box_height - temp_height,
-                                      temp_width,
-                                      '',
-                                      list,
-                                      false,
-                                       Ncurses::A_REVERSE,
-                                      box,
-                                      false)
+      @scroll_field = RNDK::Scroll.new(screen, {
+                                         :x => Ncurses.getbegx(@win),
+                                         :y => Ncurses.getbegy(@entry_field.win) + temp_height,
+                                         :width => temp_width,
+                                         :height => box_height - temp_height,
+                                         :title => '',
+                                         :items => items,
+                                         :box => box
+                                       })
 
       @scroll_field.setULchar Ncurses::ACS_LTEE
       @scroll_field.setURchar Ncurses::ACS_RTEE
 
-      # Setup the key bindings.
-      bindings.each do |from, to|
-        self.bind(:alphalist, from, :getc, to)
-      end
-
-      rndkscreen.register(:alphalist, self)
+      screen.register(:alphaitems, self)
     end
 
     # @see Widget#erase
     def erase
-      if self.valid_widget?
+      if self.valid?
         @scroll_field.erase
         @entry_field.erase
 
@@ -397,13 +228,13 @@ module RNDK
     end
 
     # @see Widget#move
-    def move(xplace, yplace, relative, refresh_flag)
+    def move(x, y, relative, refresh_flag)
       windows = [@win, @shadow_win]
       subwidgets = [@entry_field, @scroll_field]
-      self.move_specific(xplace, yplace, relative, refresh_flag, windows, subwidgets)
+      self.move_specific(x, y, relative, refresh_flag, windows, subwidgets)
     end
 
-    # The alphalist's focus resides in the entry widget. But the scroll widget
+    # The alphaitems's focus resides in the entry widget. But the scroll widget
     # will not draw items highlighted unless it has focus. Temporarily adjust
     # the focus of the scroll widget when drawing on it to get the right
     # highlighting.
@@ -416,9 +247,9 @@ module RNDK
       @scroll_field.has_focus = @save
     end
 
-    def drawMyScroller
+    def draw_scroller
       self.saveFocus
-      @scroll_field.draw(@scroll_field.box)
+      @scroll_field.draw
       self.restoreFocus
     end
 
@@ -431,14 +262,14 @@ module RNDK
     # Draws the Widget on the Screen.
     #
     # If `box` is true, it is drawn with a box.
-    def draw box
+    def draw
       Draw.drawShadow @shadow_win unless @shadow_win.nil?
 
       # Draw in the entry field.
       @entry_field.draw @entry_field.box
 
       # Draw in the scroll field.
-      self.drawMyScroller
+      self.draw_scroller
     end
 
     # Activates the Alphalist Widget, letting the user interact with it.
@@ -455,7 +286,7 @@ module RNDK
       ret = 0
 
       # Draw the widget.
-      self.draw(@box)
+      self.draw
 
       # Activate the widget.
       ret = @entry_field.activate actions
@@ -478,19 +309,19 @@ module RNDK
     # Besides normal keybindings (arrow keys and such), see
     # Widget#set_exit_type to see how the Widget exits.
     #
-    def inject char
-      ret = -1
+    def inject input
+      ret = false
 
-      self.draw @box
+      self.draw
 
       # Inject a character into the widget.
-      ret = @entry_field.inject char
+      ret = @entry_field.inject input
 
       # Copy the eixt type from the entry field.
       @exit_type = @entry_field.exit_type
 
       # Determine the exit status.
-      ret = -1 if @exit_type == :EARLY_EXIT
+      ret = false if @exit_type == :EARLY_EXIT
 
       @result_data = ret
       ret
@@ -499,19 +330,19 @@ module RNDK
     # Sets multiple attributes of the Widget.
     #
     # See Alphalist#initialize.
-    def set(list, filler_char, highlight, box)
-      self.set_contents   list
+    def set(items, filler_char, highlight, box)
+      self.set_contents   items
       self.set_filler_char filler_char
       self.set_highlight highlight
       self.set_box box
     end
 
-    # This function sets the information inside the alphalist.
-    def set_contents list
-      return if not self.createList list
+    # This function sets the information inside the alphaitems.
+    def set_contents items
+      return if not self.create_items items
 
-      # Set the information in the scrolling list.
-      @scroll_field.set(@list, @list_size, false,
+      # Set the information in the scrolling items.
+      @scroll_field.set(@items, @items_size, false,
           @scroll_field.highlight, @scroll_field.box)
 
       # Clean out the entry field.
@@ -520,13 +351,13 @@ module RNDK
 
       # Redraw the widget.
       self.erase
-      self.draw @box
+      self.draw
     end
 
     # This returns the contents of the widget.
     def getContents size
-      size << @list_size
-      return @list
+      size << @items_size
+      return @items
     end
 
     # Get/set the current position in the scroll widget.
@@ -535,13 +366,13 @@ module RNDK
     end
 
     def set_current_item item
-      if @list_size != 0
+      if @items_size != 0
         @scroll_field.set_current_item item
-        @entry_field.setValue @list[@scroll_field.get_current_item]
+        @entry_field.setValue @items[@scroll_field.get_current_item]
       end
     end
 
-    # This sets the filler character of the entry field of the alphalist.
+    # This sets the filler character of the entry field of the alphaitems.
     def set_filler_char char
       @filler_char = char
       @entry_field.set_filler_char char
@@ -593,22 +424,22 @@ module RNDK
     end
 
     # This sets the background attribute of the widget.
-    def set_bg_attrib(attrib)
-      @entry_field.set_bg_attrib(attrib)
-      @scroll_field.set_bg_attrib(attrib)
+    def set_bg_color(attrib)
+      @entry_field.set_bg_color(attrib)
+      @scroll_field.set_bg_color(attrib)
     end
 
     def destroyInfo
-      @list = ''
-      @list_size = 0
+      @items = ''
+      @items_size = 0
     end
 
-    # This destroys the alpha list
+    # This destroys the alpha items
     def destroy
       self.destroyInfo
 
       # Clean the key bindings.
-      self.clean_bindings(:alphalist)
+      self.clean_bindings
 
       @entry_field.destroy
       @scroll_field.destroy
@@ -617,38 +448,33 @@ module RNDK
       RNDK.window_delete(@shadow_win)
       RNDK.window_delete(@win)
 
-      # Unregister the object.
-      RNDK::Screen.unregister(:alphalist, self)
+      # Unregister the widget.
+      @screen.unregister self
     end
 
-    # This function sets the pre-process function.
-    def setPreProcess(callback, data)
-      @entry_field.setPreProcess(callback, data)
+    # @see Widget#bind_signal
+    def bind_signal(signal, &action)
+      @entry_field.bind_signal(signal, action)
     end
 
-    # This function sets the post-process function.
-    def setPostProcess(callback, data)
-      @entry_field.setPostProcess(callback, data)
-    end
-
-    def createList list
-      if list.size >= 0
-        newlist = []
+    def create_items items
+      if items.size >= 0
+        newitems = []
 
         # Copy in the new information.
         status = true
-        (0...list.size).each do |x|
-          newlist << list[x]
-          if newlist[x] == 0
+        (0...items.size).each do |x|
+          newitems << items[x]
+          if newitems[x] == 0
             status = false
             break
           end
         end
         if status
           self.destroyInfo
-          @list_size = list.size
-          @list = newlist
-          @list.sort!
+          @items_size = items.size
+          @items = newitems
+          @items.sort!
         end
       else
         self.destroyInfo
@@ -673,8 +499,178 @@ module RNDK
       super(@win)
     end
 
-    def object_type
-      :alphalist
+
+    protected
+
+    def autocomplete
+      scrollp = self.scroll_field
+      entry   = self.entry_field
+
+      if scrollp.items_size > 0
+        # Adjust the scrolling items.
+        self.injectMyScroller Ncurses::KEY_UP
+
+        # Set the value in the entry field.
+        current = RNDK.chtype2Char scrollp.item[scrollp.current_item]
+        entry.setValue current
+        entry.draw entry.box
+        return true
+      end
+
+      RNDK.beep
+      false
+    end
+
+    def adjust_items
+      entry = self.entry_field
+      scrollp = nil
+      selected = -1
+      ret = 0
+      alt_words = []
+
+      if entry.info.size == 0
+        RNDK.beep
+        return true
+      end
+
+      # Look for a unique word match.
+      index = RNDK.search_list(self.items, self.items.size, entry.info)
+
+      # if the index is less than zero, return we didn't find a match
+      if index < 0
+        RNDK.beep
+        return true
+      end
+
+      # Did we find the last word in the items?
+      if index == self.items.size - 1
+        entry.setValue self.items[index]
+        entry.draw entry.box
+        return true
+      end
+
+      # Ok, we found a match, is the next item similar?
+      len = [entry.info.size, self.items[index + 1].size].min
+      ret = self.items[index + 1][0...len] <=> entry.info
+      if ret == 0
+        current_index = index
+        match = 0
+        selected = -1
+
+        # Start looking for alternate words
+        # FIXME(original): bsearch would be more suitable.
+        while (current_index < self.items.size) and
+            ((self.items[current_index][0...len] <=> entry.info) == 0)
+          alt_words << self.items[current_index]
+          current_index += 1
+        end
+
+        # Determine the height of the scrolling items.
+        height = if alt_words.size < 8 then alt_words.size + 3 else 11 end
+
+        # Create a scrolling items of close matches.
+        scrollp = RNDK::Scroll.new(entry.screen, {
+                                     :x => RNDK::CENTER,
+                                     :y => RNDK::CENTER,
+                                     :width => -30,
+                                     :height => height,
+                                     :title => "<C></B/5>Possible Matches.",
+                                     :items => alt_words,
+                                     :numbers => true
+                                   })
+
+        # Allow them to select a close match.
+        match = scrollp.activate
+        selected = scrollp.current_item
+
+        # Check how they exited the items.
+        if scrollp.exit_type == :ESCAPE_HIT
+          # Destroy the scrolling items.
+          scrollp.destroy
+
+          RNDK.beep
+
+          # Redraw the self and return.
+          self.draw(self.box)
+          return true
+        end
+
+        # Destroy the scrolling items.
+        scrollp.destroy
+
+        # Set the entry field to the selected value.
+        entry.set(alt_words[match], entry.min, entry.max, entry.box)
+
+        # Move the highlight bar down to the selected value.
+        (0...selected).each do |x|
+          self.injectMyScroller(Ncurses::KEY_DOWN)
+        end
+
+        # Redraw the self.
+        self.draw self.box
+
+      else
+        # Set the entry field with the found item.
+        entry.set(self.items[index], entry.min, entry.max, entry.box)
+        entry.draw entry.box
+      end
+      true
+    end
+
+    def pre_process_entry_field(input)
+      scrollp = self.scroll_field
+      entry = self.entry_field
+      info_len = entry.info.size
+      result = 1
+      empty = false
+
+      if self.is_bound? input
+        result = 1  # Don't try to use this key in editing
+
+      elsif (RNDK.is_char?(input) &&
+             input.chr.match(/^[[:alnum:][:punct:]]$/)) ||
+        [Ncurses::KEY_BACKSPACE, Ncurses::KEY_DC].include?(input)
+
+        index = 0
+        curr_pos = entry.screen_col + entry.left_char
+        pattern = entry.info.clone
+
+        if [Ncurses::KEY_BACKSPACE, Ncurses::KEY_DC].include? input
+
+          curr_pos -= 1 if input == Ncurses::KEY_BACKSPACE
+
+          pattern.slice!(curr_pos) if curr_pos >= 0
+
+        else
+          front   = (pattern[0...curr_pos] or '')
+          back    = (pattern[curr_pos..-1] or '')
+          pattern = front + input.chr + back
+        end
+
+        if pattern.size == 0
+          empty = true
+
+        elsif (index = RNDK.search_list(self.items,
+                                         self.items.size,
+                                         pattern)) >= 0
+
+          # XXX: original uses n scroll downs/ups for <10 positions change
+          scrollp.set_position(index)
+          self.draw_scroller
+
+        else
+          RNDK.beep
+          result = 0
+        end
+      end
+
+      if empty
+        scrollp.set_position(0)
+        self.draw_scroller
+      end
+
+      result
     end
+
   end
 end