watir 1.8.1 → 1.9.0.rc1

data/watir.gemspec

@@ -2,10 +2,9 @@ require 'watir-rdoc'
 
 $__watir_source_patterns = [
     'CHANGES', 'rakefile.rb', 'VERSION', "README.rdoc", 'watir.gemspec', 'watir-rdoc.rb', 'LICENSE',
-    'lib/watir/*.rb', 'lib/watir/AutoItX3.dll', 'lib/watir/AutoItX.chm',
-    'unittests/*.rb', 'unittests/html/*.html', 'unittests/html/images/*.*',
+    'lib/watir/*.rb', 'lib/watir/dialogs/*.rb', 'unittests/*.rb', 'unittests/html/*.html', 'unittests/html/images/*.*',
     'unittests/other/*.rb', 'unittests/testcase/*.rb', 'unittests/windows/*.rb',
-    'lib/watir/IEDialog/Release/IEDialog.dll', 'lib/watir/win32ole/win32ole.so',
+    'lib/watir/IEDialog/Release/IEDialog.dll', 'lib/watir/win32ole/1.8.7/win32ole.so',
     'lib/watir/contrib/*.rb'] +
     $WATIR_EXTRA_RDOC_FILES
 
@@ -31,6 +30,7 @@ spec = Gem::Specification.new do |s|
   s.homepage = 'http://www.watir.com/'
 
   s.platform = Gem::Platform::RUBY
+  s.required_ruby_version = '>= 1.8.7'
   s.requirements << 'Microsoft Windows running Internet Explorer 5.5 or later.'
   s.require_path = 'lib'
 
@@ -39,6 +39,8 @@ spec = Gem::Specification.new do |s|
   s.add_dependency 'commonwatir', '= ' + version
   s.add_dependency 'firewatir', '= ' + version
   s.add_dependency 'nokogiri'
+  s.add_dependency 'ffi', '~>1.0'
+  s.add_dependency 'rautomation', '~>0.5'
 
   s.has_rdoc = true
   s.rdoc_options += $WATIR_RDOC_OPTIONS
@@ -54,4 +56,4 @@ spec = Gem::Specification.new do |s|
     }
   }.flatten
 
-end
+end

metadata

@@ -1,13 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: watir
 version: !ruby/object:Gem::Version 
-  hash: 53
-  prerelease: false
+  hash: 15424167
+  prerelease: 6
   segments: 
   - 1
-  - 8
+  - 9
+  - 0
+  - rc
   - 1
-  version: 1.8.1
+  version: 1.9.0.rc1
 platform: ruby
 authors: 
 - Bret Pettichord
@@ -15,8 +17,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-10 00:00:00 +03:00
-default_executable: 
+date: 2011-06-05 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: win32-process
@@ -58,12 +59,14 @@ dependencies:
     requirements: 
     - - "="
       - !ruby/object:Gem::Version 
-        hash: 53
+        hash: 15424167
         segments: 
         - 1
-        - 8
+        - 9
+        - 0
+        - rc
         - 1
-        version: 1.8.1
+        version: 1.9.0.rc1
   type: :runtime
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
@@ -74,12 +77,14 @@ dependencies:
     requirements: 
     - - "="
       - !ruby/object:Gem::Version 
-        hash: 53
+        hash: 15424167
         segments: 
         - 1
-        - 8
+        - 9
+        - 0
+        - rc
         - 1
-        version: 1.8.1
+        version: 1.9.0.rc1
   type: :runtime
   version_requirements: *id004
 - !ruby/object:Gem::Dependency 
@@ -96,6 +101,36 @@ dependencies:
         version: "0"
   type: :runtime
   version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: ffi
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 0
+        version: "1.0"
+  type: :runtime
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: rautomation
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 0
+        - 5
+        version: "0.5"
+  type: :runtime
+  version_requirements: *id007
 description: "    WATIR is \"Web Application Testing in Ruby\". Watir (pronounced water) is a free,\n    open-source functional testing tool for automating browser-based tests of web applications.\n    It works with applications written in any language.\n    Watir drives the Internet Explorer browser the same way an end user would.\n    It clicks links, fills in forms, presses buttons.\n    Watir also checks results, such as whether expected text appears on the\n    page, or whether a control is enabled.\n    Watir can test web applications written in any language.\n    Watir is a Ruby library that works with Internet Explorer on Windows.\n"
 email: watir-general@groups.google.com
 executables: 
@@ -113,13 +148,11 @@ files:
 - watir-rdoc.rb
 - LICENSE
 - lib/watir/camel_case.rb
-- lib/watir/clickJSDialog.rb
 - lib/watir/close_all.rb
 - lib/watir/collections.rb
 - lib/watir/container.rb
 - lib/watir/cookiemanager.rb
 - lib/watir/core.rb
-- lib/watir/dialog.rb
 - lib/watir/element.rb
 - lib/watir/element_collections.rb
 - lib/watir/form.rb
@@ -138,17 +171,13 @@ files:
 - lib/watir/module.rb
 - lib/watir/non_control_elements.rb
 - lib/watir/page-container.rb
-- lib/watir/popup.rb
 - lib/watir/process.rb
 - lib/watir/screen_capture.rb
-- lib/watir/setFileDialog.rb
 - lib/watir/table.rb
 - lib/watir/win32.rb
 - lib/watir/win32ole.rb
-- lib/watir/winClicker.rb
-- lib/watir/WindowHelper.rb
-- lib/watir/AutoItX3.dll
-- lib/watir/AutoItX.chm
+- lib/watir/dialogs/file_upload.rb
+- lib/watir/dialogs/javascript.rb
 - unittests/all_tests.rb
 - unittests/buttons_xpath_test.rb
 - unittests/checkbox_test.rb
@@ -171,6 +200,7 @@ files:
 - unittests/form_xpath_test.rb
 - unittests/frame_test.rb
 - unittests/google_form_test.rb
+- unittests/ie9_test.rb
 - unittests/ie_exists_test.rb
 - unittests/ie_mock.rb
 - unittests/ie_test.rb
@@ -189,7 +219,6 @@ files:
 - unittests/pagecontainstext_test.rb
 - unittests/parent_child_test.rb
 - unittests/perf_test.rb
-- unittests/popups_test.rb
 - unittests/pre_test.rb
 - unittests/radios_test.rb
 - unittests/radios_xpath_test.rb
@@ -208,6 +237,8 @@ files:
 - unittests/textfields_test.rb
 - unittests/textfields_xpath_test.rb
 - unittests/textfield_for_ch_char_test.rb
+- unittests/version_test.rb
+- unittests/win32ole_so_test.rb
 - unittests/window_tests.rb
 - unittests/xpath_tests.rb
 - unittests/html/blankpage.html
@@ -228,6 +259,8 @@ files:
 - unittests/html/frame_links.html
 - unittests/html/frame_multi.html
 - unittests/html/google_india.html
+- unittests/html/ie_9.html
+- unittests/html/iframe.html
 - unittests/html/iframeTest.html
 - unittests/html/iframeTest1.html
 - unittests/html/iframeTest2.html
@@ -275,19 +308,12 @@ files:
 - unittests/html/images/square.jpg
 - unittests/html/images/triangle.jpg
 - unittests/other/all_tests_concurrent.rb
-- unittests/other/jscriptExtraAlert.rb
-- unittests/other/jscriptExtraConfirmCancel.rb
-- unittests/other/jscriptExtraConfirmOk.rb
-- unittests/other/jscriptPushButton.rb
-- unittests/other/jscript_test.rb
 - unittests/other/navigate_exception_test.rb
 - unittests/other/rexml_unit_test.rb
 - unittests/other/screen_capture_test.rb
 - unittests/other/testcase_method_order_test.rb
 - unittests/other/testcase_verify_test.rb
 - unittests/other/wait_until_test.rb
-- unittests/other/WindowLogonExample.rb
-- unittests/other/WindowLogonExtra.rb
 - unittests/windows/attach_to_existing_window_test.rb
 - unittests/windows/attach_to_new_window_test.rb
 - unittests/windows/close_window_test.rb
@@ -300,12 +326,11 @@ files:
 - unittests/windows/open_close_test.rb
 - unittests/windows/send_keys_test.rb
 - lib/watir/IEDialog/Release/IEDialog.dll
-- lib/watir/win32ole/win32ole.so
+- lib/watir/win32ole/1.8.7/win32ole.so
 - lib/watir/contrib/enabled_popup.rb
 - lib/watir/contrib/ie-new-process.rb
 - lib/watir/contrib/page_checker.rb
 - bin/watir-console
-has_rdoc: true
 homepage: http://www.watir.com/
 licenses: []
 
@@ -326,23 +351,27 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
+      hash: 57
       segments: 
-      - 0
-      version: "0"
+      - 1
+      - 8
+      - 7
+      version: 1.8.7
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version 
-      hash: 3
+      hash: 25
       segments: 
-      - 0
-      version: "0"
+      - 1
+      - 3
+      - 1
+      version: 1.3.1
 requirements: 
 - Microsoft Windows running Internet Explorer 5.5 or later.
 rubyforge_project: Watir
-rubygems_version: 1.3.7
+rubygems_version: 1.7.2
 signing_key: 
 specification_version: 3
 summary: Automated testing tool for web applications.

data/lib/watir/WindowHelper.rb

@@ -1,49 +0,0 @@
-require 'watir/win32ole'
-require 'watir/ie' # for Watir.autoit
-
-class WindowHelper
-    @@ie_window_name = "Windows Internet Explorer"
-    def initialize()
-        @autoit = Watir.autoit
-    end
-    
-    def push_alert_button
-        @autoit.WinWait @@ie_window_name, ""
-        @autoit.Send "{ENTER}"
-    end
-    
-    def push_confirm_button_ok
-        @autoit.WinWait @@ie_window_name, ""
-        @autoit.Send "{ENTER}"
-    end
-    
-    def push_confirm_button_cancel
-        @autoit.WinWait @@ie_window_name, ""
-        @autoit.Send "{ESCAPE}"
-    end
-    
-    def push_security_alert_yes
-        @autoit.WinWait "Security Alert", ""
-        @autoit.Send "{TAB}"
-        @autoit.Send "{TAB}"
-        @autoit.Send "{SPACE}"
-    end
-        
-    def logon(title,name = 'john doe',password = 'john doe')
-        @autoit.WinWait title, ""
-        @autoit.Send name
-        @autoit.Send "{TAB}"
-        @autoit.Send password
-        @autoit.Send "{ENTER}"
-    end
-    
-    def WindowHelper.check_autoit_installed
-        begin
-          Watir.autoit
-        rescue
-            raise Watir::Exception::WatirException, "The AutoIt dll must be correctly registered for this feature to work properly"
-        end
-    end
-end
-
-

data/lib/watir/clickJSDialog.rb

@@ -1,19 +0,0 @@
-#
-#  clickJSDialog.rb 
-#
-#
-# This file contains the JS clicker when it runs as a separate process
-
-$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), '..'))
-puts $LOAD_PATH
-require 'watir/winClicker'
-
-button = "OK"
-button = ARGV[0] unless ARGV[0] == nil
-sleepTime = 0
-sleepTime = ARGV[1] unless ARGV[1] == nil
-
-
-clicker= WinClicker.new
-result = clicker.clickJavaScriptDialog( button )
-clicker = nil

data/lib/watir/dialog.rb

@@ -1,46 +0,0 @@
-require 'watir/ie'
-# TODO: move this file to watir/contrib
-
-module Watir
-  
-  class Dialog
-    WindowName = 'Windows Internet Explorer'    
-    def button(name)
-      DialogButton.new(name)
-    end
-    def close
-      # TODO: register autoit before use
-      autoit = WIN32OLE.new('AutoItX3.Control')
-      autoit.WinClose WindowName, ""
-    end
-    def exists?
-      # TODO: register autoit before use
-      autoit = WIN32OLE.new('AutoItX3.Control')
-      found = autoit.WinWait(WindowName, "", 1)
-      return found == 1
-    end 
-  end
-  
-  def dialog
-    Dialog.new
-  end
-  
-  class DialogButton
-    def initialize(name)
-      @name = name
-    end
-    def click
-      # TODO: register autoit before use
-      autoit = WIN32OLE.new('AutoItX3.Control')
-      autoit.WinWait Dialog::WindowName, "", 1
-      name_pattern = Regexp.new "^#{@name}$"
-      unless name_pattern =~ autoit.WinGetText(Dialog::WindowName, "")
-        raise Watir::Exception::UnknownObjectException
-      end
-      autoit.Send "{ENTER}"
-    end
-  end
-  
-end
-
-

data/lib/watir/popup.rb

@@ -1,30 +0,0 @@
-module Watir
-  # POPUP object
-  class PopUp
-    def initialize(container)
-      @container = container
-      @page_container = container.page_container
-    end
-    
-    def button(caption)
-      return JSButton.new(@container.getIE.hwnd, caption)
-    end
-  end
-  
-  class JSButton
-    def initialize(hWnd, caption)
-      @hWnd = hWnd
-      @caption = caption
-    end
-    
-    def startClicker(waitTime=3)
-      clicker = WinClicker.new
-      clicker.clickJSDialog_Thread
-      # clickerThread = Thread.new(@caption) {
-      #   sleep waitTime
-      #   puts "After the wait time in startClicker"
-      #   clickWindowsButton_hwnd(hwnd, buttonCaption)
-      #}
-    end
-  end
-end

data/lib/watir/setFileDialog.rb

@@ -1,16 +0,0 @@
-#
-#  setFileDialog.rb 
-#
-#
-# This file contains the file dialog when it runs as a separate process
-
-$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), '..'))
-puts $LOAD_PATH
-require 'watir/winClicker'
-
-filepath = "invalid path passed to setFileDialog.rb"
-filepath = ARGV[0] unless ARGV[0] == nil
-
-clicker= WinClicker.new
-clicker.setFileRequesterFileName(filepath)
-clicker = nil

data/lib/watir/winClicker.rb

@@ -1,460 +0,0 @@
-=begin rdoc
-   This is Watir's window clicker helper class, uses Win32 api
-   calls to access buttons and windows. 
-
-   Typical usage:
-    # include this file in your script
-    require "watir/winClicker.rb"
-
-    # create a new instance of WinClicker and use it
-    wc = WinClicker.new
-    wc.clickWindowsButton("My Window", "Click Me", 30)
-
-=end
-
-#
-#   class to click javascript dialog boxes, file requester dialogs etc 
-require 'dl/import'
-require 'dl/struct'
-require "timeout"
-require 'Win32API'
-
-class WinClicker
-
-  WM_CLOSE    = 0x0010
-  WM_KEYDOWN  = 0x0100
-  WM_KEYUP    = 0x0101
-  WM_CHAR     = 0x0102
-  BM_CLICK    = 0x00F5
-  WM_COMMAND  = 0x0111
-  WM_SETTEXT  = 0x000C
-  WM_GETTEXT  = 0x000D
-
-  HWND_TOP = 0
-  HWND_BOTTOM = 1
-  HWND_TOPMOST = -1
-  HWND_NOTOPMOST = -2
-
-  SWP_SHOWWINDOW   = 0x40
-  SWP_NOSIZE = 1
-  SWP_NOMOVE = 2
-
-  TRUE_1 = 1
-
-  # these are constants for commonly used windows windows
-  WINCLASS_DIALOG = "32770"
-
-  # these are the most used methods
-
-  def initialize
-    @User32 = DL.dlopen("user32")
-    # we must determine the path we are in
-    @path_to_clicker = '"' + File.expand_path(File.dirname(__FILE__)) + '"'
-  end
-
-
-  # The system function passes command to the command interpreter, which executes the string as an operating-system command
-  # http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vccore98/html/_crt_system.2c_._wsystem.asp
-  # using win32api
-  def winsystem(command)
-    pid  =  Win32API.new("crtdll", "system", ['P'], 'L').Call(command)
-  end
-
-  # returns the short path version of a long path
-  # 8.3 style
-  def getShortFileName(longName)
-    size = 255
-    buffer = " " * 255
-    returnSize = Win32API.new("kernel32" , "GetShortPathNameA" , 'ppl'  , 'L').Call(longName ,  buffer , size )
-    a = ""
-    a = a + buffer[0...returnSize]        
-    return a
-  end
-
-  # Set the first edit box in the Choose file dialog to textToSet
-  # we may need to play with the default try count.  3 is a reasonably safe value.
-  def setFileRequesterFileName( textToSet, tryCount = 3 )
-    for i in (1..tryCount)
-      # first set the Choose File Window to be active
-      hWnd = getWindowHandle("Choose file" )
-      if hWnd != -1
-        makeWindowActive(hWnd)
-        setTextValueForFileNameField( hWnd , textToSet) 
-        clickWindowsButton_hwnd(hWnd, "&Open")
-        return true
-      end            
-    end
-    return false
-  end
-
-  # fire off setting the file name for the Choose file dialog
-  # in a new process
-  def setFileRequesterFileName_newProcess ( textToSet )
-    myapp = "rubyw #{@path_to_clicker}/setFileDialog.rb #{textToSet}"
-    # first argument to system call is a window title, in this case blank ""      
-    winsystem( "start \"\" #{myapp}" )
-  end
-
-  # Return the text value from the first combo box 
-  # on the Choose file dialog or nil if not found
-  def getFileRequesterFileName()
-    # first set the Choose File Window to be active
-    hWnd = getWindowHandle("Choose file" )
-    if hWnd != -1
-      makeWindowActive(hWnd)
-      return getTextValueForFileNameField( hWnd ) 
-    else
-      return nil
-    end
-  end
-
-  # Click on a dialog with title of "Internet Explorer"
-  # Default button to click is "OK"
-  # parenthWnd not used
-  def clickJavaScriptDialog(button="OK" , parenthWnd = -1)
-    clickWindowsButton("Internet Explorer" , button )
-  end
-
-  # Calls system to launch a new process to click on the button
-  # defaults to "OK" button
-  def clickJSDialog_NewProcess(button = "OK" )
-    myapp = "rubyw #{@path_to_clicker}/clickJSDialog.rb #{button}"
-    log "Starting win clicker in a new process. Looking for button #{button}"
-    log "Starting app: #{myapp}"
-    # first argument to system call is a window title, in this case blank ""
-    winsystem( "start \"\" #{myapp}" )
-  end
-
-
-  # as a thread
-  def clickJSDialog_Thread(button = "OK" )
-    sleep 3
-    n = 0
-    while n < 3
-      sleep 1
-      clickWindowsButton("Internet Explorer" , button )
-      n=n+1
-    end
-  end
-
-  # Looks for a window titled "Security Alert", clicks
-  # on Yes button
-  def clearSecurityAlertBox
-    clickWindowsButton("Security Alert" , "&Yes" )
-  end
-  alias :clear_security_alert :clearSecurityAlertBox
-
-  # Returns the parent handle for the given child handle
-  def getParent (childhWnd )
-    # pass a hWnd into this function and it will return the parent hWnd
-    getParentWindow = @User32['GetParent' , 'II' ]
-    a , b = getParentWindow.call(childhWnd )
-    return a
-  end
-  alias :get_parent :getParent
-
-  def with_dl_callback(type, prc)
-    callback = DL.callback(type, &prc)
-    error = nil
-    begin
-      yield callback
-    ensure
-      DL.remove_callback(callback)
-    end
-  end
-
-  # Enumerates open windows and
-  # returns a window handle from a given title and window class
-  # Window class and title are matched regexes
-  def getWindowHandle(title, winclass = "" )
-    enum_windows = @User32['EnumWindows', 'IPL']
-    get_class_name = @User32['GetClassName', 'ILpI']
-    get_caption_length = @User32['GetWindowTextLengthA' ,'LI' ]    # format here - return value type (Long) followed by parameter types - int in this case -      see http://www.ruby-lang.org/cgi-bin/cvsweb.cgi/~checkout~/ruby/ext/dl/doc/dl.txt?
-    get_caption = @User32['GetWindowTextA', 'iLsL' ] 
-
-    len = 32
-    buff = " " * len
-    classMatch = false
-
-    bContinueEnum = -1  # Windows "true" to continue enum_windows.
-    found_hwnd = -1
-
-    enum_windows_proc = lambda {|hwnd,lparam|
-      sleep 0.05
-      r,rs = get_class_name.call(hwnd, buff, buff.size)
-
-      if winclass != "" then
-        if /#{winclass}/ =~ rs[1].to_s
-          classMatch = true
-        end
-      else
-        classMatch = true
-      end
-
-      if classMatch ==true
-        textLength, a = get_caption_length.call(hwnd)
-        captionBuffer = " " * (textLength+1)
-        t ,  textCaption  = get_caption.call(hwnd, captionBuffer  , textLength+1)    
-        if /#{title}/ =~ textCaption[1].to_s
-          found_hwnd = hwnd
-          bContinueEnum = 0 # False, discontinue enum_windows
-        end
-        bContinueEnum
-      else
-        bContinueEnum
-      end
-    }
-    with_dl_callback('ILL',enum_windows_proc) do |callback|
-      r,rs = enum_windows.call(callback, 0)
-    end 
-    return found_hwnd
-  end
-  alias :get_window_handle :getWindowHandle 
-
-  # Call SwitchToThisWindow win32api which will 
-  # The SwitchToThisWindow function is called to switch focus to a specified window
-  # and bring it to the foreground
-  def makeWindowActive (hWnd)
-    switch_to_window = @User32['SwitchToThisWindow' , 'pLI'  ]
-    # set it to be the one with focus
-    switch_to_window.call(hWnd , 1)
-  end
-  alias :make_window_active :makeWindowActive 
-
-  # Posts a message to the handle passed in to click 
-  def clickButtonWithHandle(buttonhWnd)
-    post_message = @User32['PostMessage', 'ILILL']
-    r,rs = post_message.call(buttonhWnd, BM_CLICK, 0, 0)
-  end
-  alias :click_button_with_handle :clickButtonWithHandle 
-
-  # Based on the parent window handle passed in, 
-  # click on the button with the given caption.      
-  def clickWindowsButton_hwnd (hwnd , buttonCaption )
-    makeWindowActive(hwnd)
-    d = getChildHandle( hwnd , buttonCaption )
-    if d != -1 
-      makeWindowActive(hwnd)
-      clickButtonWithHandle(d)
-    else
-      return false
-    end
-    return true
-  end
-  alias :click_windows_button_hwnd :clickWindowsButton_hwnd 
-
-  # this clicks the button with the name in the window with the caption. It keeps looking for the button until
-  # until the timeout expires
-  def clickWindowsButton (windowCaption , buttonCaption , maxWaitTime=30 )
-    sleep 1
-    hwnd = -1
-    begin 
-      timeout(maxWaitTime) do
-        hwnd = getWindowHandle(windowCaption)
-        while hwnd == -1 
-          hwnd = getWindowHandle(windowCaption)
-          sleep 0.5
-        end
-        makeWindowActive(hwnd)
-      end
-    rescue Timeout::Error 
-      return false
-    rescue => e
-      raise e
-    end
-    if hwnd != -1 
-      makeWindowActive(hwnd)
-    else
-    end
-    d = getChildHandle( hwnd , buttonCaption )
-    if d != -1 
-      makeWindowActive(hwnd)
-      clickButtonWithHandle(d)
-    else
-      return false
-    end
-    return true
-  end
-  alias :click_windows_button :clickWindowsButton 
-
-  # Enumerate through children of the parent hwnd, pass back 
-  # the handle for the control with the given caption
-  # the caption is compared as a regex
-  def getChildHandle ( hWnd , childCaption )
-    enum_childWindows = @User32['EnumChildWindows' , 'IIPL' ]
-    get_caption_length = @User32['GetWindowTextLengthA' ,'LI' ]    # format here - return value type (Long) followed by parameter types - int in this case -      see http://www.ruby-lang.org/cgi-bin/cvsweb.cgi/~checkout~/ruby/ext/dl/doc/dl.txt?
-    get_caption = @User32['GetWindowTextA', 'iLsL' ] 
-    match_hwnd = -1  # hWnd of handle matching childCaption
-    buff = " " * 16
-    get_class_name = @User32['GetClassName', 'ILpI']
-
-    bContinueEnum = -1
-    enum_childWindowsProc = lambda {|chwnd,lparam|
-      r,rs = get_class_name.call(chwnd, buff, buff.size)
-      textLength, a = get_caption_length.call(chwnd)
-      captionBuffer = " " * (textLength+1)
-
-      t ,  textCaption  = get_caption.call(chwnd, captionBuffer  , textLength+1)    
-      if /#{childCaption}/ =~ textCaption[1].to_s then
-        match_hwnd = chwnd
-        bContinueEnum = 0  # Windows "false" to discontinue enum_childWindow
-      end
-      bContinueEnum
-    }
-    with_dl_callback('ILL',enum_childWindowsProc) do |callback|
-      r  = enum_childWindows.call(hWnd, callback  ,0)
-    end
-    return match_hwnd
-  end
-  alias :get_chwnd :getChildHandle
-
-  # Convenience method to return Static text for 
-  # children of the window with the given caption
-  def getStaticText(caption)
-    return getStaticTextFromWindow(caption, -1)
-  end
-  alias :get_static_text :getStaticText 
-
-  # Convenience method to return Static text for 
-  # children of the window handle
-  def getStaticText_hWnd (hWnd)
-    return getStaticTextFromWindow("" , hWnd)
-  end
-  alias :get_static_text_hwnd :getStaticText_hWnd 
-
-  # Return text as an array from child controls of the window
-  # given as either a handle or with the given caption
-  # that have a class type of Static 
-  def getStaticTextFromWindow( windowCaption  , hWnd)
-    enum_childWindows = @User32['EnumChildWindows' , 'IIPL' ]
-    get_caption_length = @User32['GetWindowTextLengthA' ,'LI' ]    # format here - return value type (Long) followed by parameter types - int in this case -      see http://www.ruby-lang.org/cgi-bin/cvsweb.cgi/~checkout~/ruby/ext/dl/doc/dl.txt?
-    get_caption = @User32['GetWindowTextA', 'iLsL' ] 
-
-    staticText = []
-    buff = " " * 16
-    get_class_name = @User32['GetClassName', 'ILpI']
-
-    if hWnd == -1
-      hWnd = getWindowHandle(windowCaption)
-    end
-
-    if hWnd == -1 
-      return staticText
-    end
-
-    bContinueEnum = -1
-    enum_childWindows_proc = lambda {|hWnd,lparam|
-      r,rs = get_class_name.call(hWnd, buff, buff.size)
-      if rs[1].to_s == "Static"  # there must be a better way of detecting this
-        textLength, a = get_caption_length.call(hWnd)
-        captionBuffer = " " * (textLength+1)
-        t ,  textCaption  = get_caption.call(hWnd, captionBuffer  , textLength+1)    
-        staticText << textCaption[1].to_s
-      end
-      bContinueEnum
-    }
-    with_dl_callback('ILL',enum_childWindows_proc) do |callback|
-      r  = enum_childWindows.call(hWnd, callback  ,0)
-    end
-    return staticText
-  end
-  alias :get_static_text_from_window :getStaticTextFromWindow 
-
-  # returns the handle (or -1 if its not found) of the 
-  # nth control of this class in the parent window specified 
-  # by the window handle
-  def getHandleOfControl (hWnd , controlClass, position )
-    enum_childWindows = @User32['EnumChildWindows' , 'IIPL' ]
-    get_caption_length = @User32['GetWindowTextLengthA' ,'LI' ]    # format here - return value type (Long) followed by parameter types - int in this case -      see http://www.ruby-lang.org/cgi-bin/cvsweb.cgi/~checkout~/ruby/ext/dl/doc/dl.txt?
-    get_caption = @User32['GetWindowTextA', 'iLsL' ] 
-    control_hWnd = []
-    buff = " " * 16
-    get_class_name = @User32['GetClassName', 'ILpI']
-
-    bContinueEnum = -1
-    enum_childWindows_proc = lambda {|hWnd,lparam|
-      r,rs = get_class_name.call(hWnd, buff, buff.size)
-      if rs[1].to_s == controlClass  # there must be a better way of detecting this
-        control_hWnd << hWnd
-      end
-      bContinueEnum
-    }
-    with_dl_callback('ILL',enum_childWindows_proc) do |callback|
-      r  = enum_childWindows.call(hWnd, callback ,0)
-    end
-    controlHwnd = control_hWnd[position]
-    if controlHwnd == nil then
-      controlHwnd = -1
-    end
-    return controlHwnd 
-  end
-  alias :get_handle_of_ctrl :getHandleOfControl 
-
-  # Call set text on the given window handle
-  def setComboBoxText(hWnd , textToSet)
-    set_text(hWnd, textToSet)
-  end
-  alias :set_combo_txt :setComboBoxText 
-
-  # Call set text on the given window handle
-  def setTextBoxText(hWnd , textToSet)
-    set_text(hWnd, textToSet)
-  end
-  alias :set_textbox_txt :setTextBoxText 
-
-  # Private method to set text called by the two methods above    
-  def set_text(hWnd, textToSet)
-    send_message = @User32['SendMessage',  'ILISS']  
-    r  ,rs  = send_message.call(hWnd , WM_SETTEXT ,'',textToSet)    
-  end
-  private :set_text
-
-  # Get the text in the handle for the given control
-  def getControlText(hWnd)
-    buff = " " * 256
-    send_message = @User32['SendMessage',  'ILIIS']  
-    r  ,rs  = send_message.call(hWnd , WM_GETTEXT , 256 , buff )
-    return buff.to_s
-  end
-  alias :get_ctrl_txt :getControlText 
-
-  # get the title for the specified hwnd
-  def getWindowTitle(hWnd)
-    buff = " " * 256
-    getWindowText = @User32['GetWindowText' , 'ILSI']
-    r , rs = getWindowText.call( hWnd , buff , 256 )
-    return buff.to_s
-  end
-  alias :get_win_title :getWindowTitle
-
-  # Get the text in the first combo box 
-  # file requester methods returns nil on failure to 
-  # locate the 1st combobox
-  def getTextValueForFileNameField(parenthWnd) 
-    f = getHandleOfControl(parenthWnd, "ComboBox", 1)
-    if f == -1 then
-      # unable to find the first combobox
-      return nil
-    else
-      # we have the control and now
-      # can send it some messages
-      return getWinText(f )
-    end
-  end
-  alias :get_file_name :getTextValueForFileNameField 
-
-  # this sets the filename field to text to set
-  def setTextValueForFileNameField( parenthWnd , textToSet ) 
-    # get the handle of the nth control that is an Edit box
-    f = getHandleOfControl(parenthWnd, "Edit" , 0 )
-    if f == -1 then
-      # unable to get a handle on the first edit control
-      return false
-    else
-      # we found the control and can now send it some messages
-      setComboBoxText(f , textToSet)
-      return true
-    end
-  end
-  alias :set_file_name :setTextValueForFileNameField 
-end