win_gui 0.1.2 → 0.1.3

data/lib/win_gui/win_gui.rb

@@ -1,92 +1,138 @@
-require 'Win32/api'
 require 'string_extensions'
 require 'constants'
 require 'def_api'
 require 'window'
 
-#  TODO - When calling API functions, win_handle arg should default to instance var @handle of the host class
+#:stopdoc: 
+# TODO - When calling API functions, win_handle arg should default to instance var @handle of the host class
 #  TODO - Giving a hash of "named args" to def_api, like this:
 #  TODO        def_api 'ShowWindow', 'LI' , 'I', :args=>{1=>:handle=>, 2=>[:cmd, :command]}
 #  TODO - Giving a hash of "defaults" to def_api, like this:
 #  TODO        def_api 'ShowWindow', 'LI' , 'I', :defaults=>{1=>1234, 2=>'String2'}
 #  TODO - Option :class_method should define CLASS method instead of instance
+#:startdoc:
 
 module WinGui
-  self.extend DefApi
+  extend DefApi
+
 
   # Windows GUI API definitions:
 
+  ##
   # Tests whether the specified window handle identifies an existing window.
   #   A thread should not use IsWindow for a window that it did not create because the window
   #   could be destroyed after this function was called. Further, because window handles are
   #   recycled the handle could even point to a different window.
   #
+  # :call-seq:
+  # window?( win_handle )
+  #
   def_api 'IsWindow', 'L', 'L'
 
+  ##
   # Tests if the specified window, its parent window, its parent's parent window, and so forth,
   # have the WS_VISIBLE style. Because the return value specifies whether the window has the
   # WS_VISIBLE style, it may be true even if the window is totally obscured by other windows.
   #
-  def_api 'IsWindowVisible', 'L', 'L', :alias => :visible?
+  # :call-seq:
+  #   visible?( win_handle ), window_visible?( win_handle )
+  #
+  def_api 'IsWindowVisible', 'L', 'L', aliases: :visible?
 
+  ##
   # Tests whether the specified window is maximized.
   #
-  def_api 'IsZoomed', 'L', 'L', :alias => :maximized?
+  # :call-seq:
+  #   zoomed?( win_handle ), maximized?( win_handle )
+  #
+  def_api 'IsZoomed', 'L', 'L', aliases: :maximized?
 
+  ##
   # Tests whether the specified window is maximized.
   #
-  def_api 'IsIconic', 'L', 'L', :alias => :minimized?
+  # :call-seq:
+  #   iconic?( win_handle ), minimized?( win_handle )
+  #
+  def_api 'IsIconic', 'L', 'L', aliases: :minimized?
 
+  ##
   # Tests whether a window is a child (or descendant) window of a specified parent window.
   # A child window is the direct descendant of a specified parent window if that parent window
   # is in the chain of parent windows; the chain of parent windows leads from the original overlapped
   # or pop-up window to the child window.
   #
+  # :call-seq:
+  #   child?( win_handle )
+  #
   def_api 'IsChild', 'LL', 'L'
 
-  # Retrieves a handle to the top-level window whose class and window name match the specified strings.
-  #   This function does not search child windows. This function does not perform a case-sensitive search.
-  # class_name (P) - String that specifies (window) class name OR class atom created by a previous
-  #   call to the RegisterClass(Ex) function. The atom must be in the low-order word of class_name;
-  #   the high-order word must be zero. The class name can be any name registered with RegisterClass(Ex),
-  #   or any of the predefined control-class names. If this parameter is nil, it finds any window whose
-  #   title matches the win_title parameter.
-  # win_name (P) - String that specifies the window name (title). If nil, all names match.
-  # returns (L) found window handle or NIL if nothing found
+  ##
+  # Returns a handle to the top-level window whose class and window name match the specified strings.
+  # This function does not search child windows. This function does not perform a case-sensitive search.
+  #
+  # Parameters:
+  #   class_name (P) - String that specifies (window) class name OR class atom created by a previous
+  #     call to the RegisterClass(Ex) function. The atom must be in the low-order word of class_name;
+  #     the high-order word must be zero. The class name can be any name registered with RegisterClass(Ex),
+  #     or any of the predefined control-class names. If this parameter is nil, it finds any window whose
+  #     title matches the win_title parameter.
+  #   win_name (P) - String that specifies the window name (title). If nil, all names match.
+  # Return Value (L): found window handle or NIL if nothing found
+
+  # :call-seq:
+  #   win_handle = find_window( class_name, win_name )
   #
-  def_api 'FindWindow', 'PP', 'L', :zeronil => true
+  def_api 'FindWindow', 'PP', 'L', zeronil: true
 
+  ##
   # Unicode version of find_window (strings must be encoded as utf-16LE AND terminate with "\x00\x00")
   #
-  def_api 'FindWindowW', 'PP', 'L', :zeronil => true
+  # :call-seq:
+  #   win_handle = find_window_w( class_name, win_name )
+  #
+  def_api 'FindWindowW', 'PP', 'L', zeronil: true
 
+  ##
   # Retrieves a handle to a CHILD window whose class name and window name match the specified strings.
   #   The function searches child windows, beginning with the one following the specified child window.
   #   This function does NOT perform a case-sensitive search.
-  # parent (L) - Handle to the parent window whose child windows are to be searched.
-  #   If nil, the function uses the desktop window as the parent window.
-  #   The function searches among windows that are child windows of the desktop.
-  # after_child (L) - Handle to a child window. Search begins with the NEXT child window in the Z order.
-  #   The child window must be a direct child window of parent, not just a descendant window.
-  #   If after_child is nil, the search begins with the first child window of parent.
-  # win_class (P), win_title (P) - Strings that specify window class and name(title). If nil, anything matches.
-  # Returns (L) - found child window (control) handle or NIL if nothing found
-  #
-  def_api 'FindWindowEx', 'LLPP', 'L', :zeronil => true
-
-  # Returns the text of the specified window's title bar (if it has one). If the specified window is
-  #   a control, the text of the control is copied. However, GetWindowText cannot retrieve the text of
-  #   a control in another application.
-  # API improved to require only win_handle and return rstripped text
-  # win_handle (L) - Handle to the window and, indirectly, the class to which the window belongs.
-  # buffer (P) - Pointer to the buffer that will receive the text. If the string is as long or longer
-  #   than the buffer, the string is truncated and terminated with a NULL character.
-  # count (L) Specifies the maximum number of characters to copy to the buffer, including the NULL character.
-  #   If the text exceeds this limit, it is truncated.
-  # Returns (L) length, in characters, of the copied string, not including the terminating NULL character.
+  #
+  # Parameters:
+  #   parent (L) - Handle to the parent window whose child windows are to be searched.
+  #     If nil, the function uses the desktop window as the parent window.
+  #     The function searches among windows that are child windows of the desktop.
+  #   after_child (L) - Handle to a child window. Search begins with the NEXT child window in the Z order.
+  #     The child window must be a direct child window of parent, not just a descendant window.
+  #     If after_child is nil, the search begins with the first child window of parent.
+  #   win_class (P), win_title (P) - Strings that specify window class and name(title). If nil, anything matches.
+  # Returns (L): found child window handle or NIL if nothing found
+  #
+  #:call-seq:
+  #   win_handle = find_window_ex( win_handle, after_child, class_name, win_name )
+  #
+  def_api 'FindWindowEx', 'LLPP', 'L', zeronil: true
+
+  ##
+  # Returns the text of the specified window's title bar (if it has one).
+  #   If the specified window is a control, the text of the control is copied. However, GetWindowText
+  #   cannot retrieve the text of a control in another application.
+  #
+  # Original Parameters:
+  #   win_handle (L) - Handle to the window and, indirectly, the class to which the window belongs.
+  #   text (P) - Long Pointer to the buffer that is to receive the text string.
+  #   max_count (I) - Specifies the length, in TCHAR, of the buffer pointed to by the text parameter.
+  #   The class name string is truncated if it is longer than the buffer and is always null-terminated.
+  # Original Return Value (L): Length, in characters, of the copied string, not including the terminating null
+  #   character, indicates success. Zero indicates that the window has no title bar or text, if the title bar
+  #   is empty, or if the window or control handle is invalid. For extended error information, call GetLastError.
+  #
+  # Enhanced API requires only win_handle and returns rstripped text
+  #
+  # Enhanced Parameters:
+  #   win_handle (L) - Handle to the window and, indirectly, the class to which the window belongs.
+  # Returns: Window title bar text or nil
   #   If the window has no title bar or text, if the title bar is empty, or if the window or control handle
-  #   is invalid, the return value is zero.
-  # To get extended error information, call GetLastError.
+  #   is invalid, the return value is NIL. To get extended error information, call GetLastError.
   #
   # Remarks: This function CANNOT retrieve the text of an edit control in ANOTHER app.
   #   If the target window is owned by the current process, GetWindowText causes a WM_GETTEXT message to
@@ -98,105 +144,180 @@ module WinGui
   #   To retrieve the text of a control in another process, send a WM_GETTEXT message directly instead
   #   of calling GetWindowText.
   #
+  #:call-seq:
+  #   text = get_window_text( win_handle )
+  #
   def_api 'GetWindowText', 'LPI', 'L', &return_string
 
+  ##
   # Unicode version of get_window_text (returns rstripped utf-8 string)
   # API improved to require only win_handle and return rstripped string
   #
+  #:call-seq:
+  #   text = get_window_text_w( win_handle )
+  #
   def_api 'GetWindowTextW', 'LPI', 'L', &return_string('utf-8')
 
+  ##
   # Retrieves the name of the class to which the specified window belongs.
-  # API improved to require only win_handle and return rstripped  string
-  # win_handle (L) - Handle to the window and, indirectly, the class to which the window belongs.
-  # class_name (P) - Pointer to the buffer that is to receive the class name string.
-  # max_count (I) - Specifies the length, in TCHAR, of the buffer pointed to by the lpClassName parameter.
+  #
+  # Original Parameters:
+  #   win_handle (L) - Handle to the window and, indirectly, the class to which the window belongs.
+  #   class_name (P) - Long Pointer to the buffer that is to receive the class name string.
+  #   max_count (I) - Specifies the length, in TCHAR, of the buffer pointed to by the class_name parameter.
   #   The class name string is truncated if it is longer than the buffer and is always null-terminated.
-  # Returns (I) - number of TCHAR copied to the specified buffer, if the function succeeds.
-  #   Returns zero if function fails. To get extended error information, call GetLastError.
+  # Original Return Value (L): Length, in characters, of the copied string, not including the terminating null
+  #   character, indicates success. Zero indicates that the window has no title bar or text, if the title bar
+  #   is empty, or if the window or control handle is invalid. For extended error information, call GetLastError.
+  #
+  # API improved to require only win_handle and return rstripped string
+  #
+  # Enhanced Parameters:
+  #   win_handle (L) - Handle to the window and, indirectly, the class to which the window belongs.
+  # Returns: Name of the class or NIL if function fails. For extended error information, call GetLastError.
+  #
+  #:call-seq:
+  #   text = get_class_name( win_handle )
   #
   def_api 'GetClassName', 'LPI', 'I', &return_string
 
+  ##
   # Unicode version of get_class_name (returns rstripped utf-8 string)
   # API improved to require only win_handle and return rstripped string
   #
+  #:call-seq:
+  #   text = get_class_name_w( win_handle )
+  #
   def_api 'GetClassNameW', 'LPI', 'I', &return_string('utf-8')
 
-  # Retrieves the identifier of the thread that created the specified window and, optionally, the identifier
-  #   of the process that created the window.
-  # API improved to accept window handle as a single arg and return a pair of [thread, process] ids
-  # handle (L) - Handle to the window.
-  # process (P) - A POINTER to a (Long) variable that receives the process identifier.
-  # Returns (L) - Identifier of the thread that created the window.
+  ##
+  # Shows and hides windows.
   #
-  def_api 'GetWindowThreadProcessId', 'LP', 'L' do |api, *args|
-    raise 'Invalid args count' unless args.size == api.prototype.size-1
-    thread = api.call(args.first, process = [1].pack('L'))
-    [thread] + process.unpack('L')
-  end
+  # Parameters:
+  #   win_handle (L) - Handle to the window.
+  #   cmd (I) - Specifies how the window is to be shown. This parameter is ignored the first time an
+  #     application calls ShowWindow, if the program that launched the application provides a STARTUPINFO
+  #     structure. Otherwise, the first time ShowWindow is called, the value should be the value obtained
+  #     by the WinMain function in its nCmdShow parameter. In subsequent calls, cmd may be:
+  # SW_HIDE, SW_MAXIMIZE, SW_MINIMIZE, SW_SHOW, SW_SHOWMAXIMIZED, SW_SHOWMINIMIZED, SW_SHOWMINNOACTIVE,
+  # SW_SHOWNA, SW_SHOWNOACTIVATE, SW_SHOWNORMAL, SW_RESTORE, SW_SHOWDEFAULT, SW_FORCEMINIMIZE
+  #
+  # Original Return Value: - Nonzero if the window was PREVIOUSLY visible, otherwise zero
+  # Enhanced Returns: - True if the window was PREVIOUSLY visible, otherwise false
+  #
+  #:call-seq:
+  #   was_visible = show_window( win_handle, cmd )
+  #
+  def_api 'ShowWindow', 'LI', 'I', boolean: true
 
-  # Shows and hides windows.
-  # handle (L) - Handle to the window.
-  # cmd (I) - Specifies how the window is to be shown. This parameter is ignored the first time an
-  #   application calls ShowWindow, if the program that launched the application provides a STARTUPINFO
-  #  structure. Otherwise, the first time ShowWindow is called, the value should be the value obtained
-  #  by the WinMain function in its nCmdShow parameter. In subsequent calls, cmd may be:
-  #    SW_HIDE          - Hides the window and activates another window.
-  #    SW_MAXIMIZE      - Maximizes the specified window.
-  #    SW_MINIMIZE      - Minimizes the specified window, activates the next top-level window in the Z order.
-  #    SW_SHOW          - Activates the window and displays it in its current size and position.
-  #    SW_SHOWMAXIMIZED - Activates the window and displays it as a maximized window.
-  #    SW_SHOWMINIMIZED - Activates the window and displays it as a minimized window.
-  #    SW_SHOWMINNOACTIVE Displays the window as a minimized window. This value is similar to
-  #                       SW_SHOWMINIMIZED, except the window is not activated.
-  #    SW_SHOWNA        - Displays the window in its current size and position. This value is similar to
-  #                       SW_SHOW, except the window is not activated.
-  #    SW_SHOWNOACTIVATE- Displays a window in its most recent size and position. This value is similar to
-  #                       SW_SHOWNORMAL, except the window is not actived.
-  #    SW_SHOWNORMAL    - Activates and displays a window. If the window is minimized or maximized,
-  #                       the system restores it to its original size and position. An application should
-  #                       specify this flag when displaying the window for the first time.
-  #    SW_RESTORE       - Activates and displays the window. If the window is minimized or maximized,
-  #                       the system restores it to its original size and position. An application should
-  #                       specify this flag when restoring a minimized window.
-  #    SW_SHOWDEFAULT   - Sets the show state based on the SW_ value specified in the STARTUPINFO structure
-  #                       passed to the CreateProcess function by the program that started the application.
-  #    SW_FORCEMINIMIZE - Windows 2000/XP: Minimizes a window, even if the thread that owns the window
-  #                       is not responding. Only use this flag when minimizing windows from a different thread.
-  # Returns (I) - True if the window was PREVIOUSLY visible, otherwise false
-  #
-  def_api 'ShowWindow', 'LI', 'I', :boolean => true
+  # Hides the window and activates another window.
+  SW_HIDE           = 0
+  # Same as SW_SHOWNORMAL
+  SW_NORMAL         = 1
+  # Activates and displays a window. If the window is minimized or maximized, the system restores it to its
+  # original size and position. An application should specify this flag when displaying the window for the first time.
+  SW_SHOWNORMAL     = 1
+  # Activates the window and displays it as a minimized window.
+  SW_SHOWMINIMIZED  = 2
+  # Activates the window and displays it as a maximized window.
+  SW_SHOWMAXIMIZED  = 3
+  # Maximizes the specified window.
+  SW_MAXIMIZE       = 3
+  # Displays a window in its most recent size and position. Similar to SW_SHOWNORMAL, but the window is not activated.
+  SW_SHOWNOACTIVATE = 4
+  # Activates the window and displays it in its current size and position.
+  SW_SHOW           = 5
+  # Minimizes the specified window, activates the next top-level window in the Z order.
+  SW_MINIMIZE       = 6
+  # Displays the window as a minimized window. Similar to SW_SHOWMINIMIZED, except the window is not activated.
+  SW_SHOWMINNOACTIVE= 7
+  # Displays the window in its current size and position. Similar to SW_SHOW, except the window is not activated.
+  SW_SHOWNA         = 8
+  # Activates and displays the window. If the window is minimized or maximized, the system restores it to its original
+  # size and position. An application should specify this flag when restoring a minimized window.
+  SW_RESTORE        = 9
+  # Sets the show state based on the SW_ value specified in the STARTUPINFO structure  passed to the CreateProcess
+  # function by the program that started the application.
+  SW_SHOWDEFAULT    = 10
+  # Windows 2000/XP: Minimizes a window, even if the thread that owns the window is not responding. Only use this
+  # flag when minimizing windows from a different thread.
+  SW_FORCEMINIMIZE  = 11
 
   def hide_window(handle)
     show_window(handle, SW_HIDE)
   end
 
-  # Retrieves the dimensions of the specified window bounding rectangle. Dimensions are given relative
-  #   to the upper-left corner of the screen.
+  ##
+  # Retrieves the identifier of the thread that created the specified window
+  #   and, optionally, the identifier of the process that created the window.
+  #
+  # Original Parameters:
+  #   handle (L) - Handle to the window.
+  #   process (P) - A POINTER to a (Long) variable that receives the process identifier.
+  # Original Return (L): Identifier of the thread that created the window.
+  #
+  # API improved to accept window handle as a single arg and return a pair of [thread, process] ids
+  #
+  # New Parameters:
+  #   handle (L) - Handle to the window.
+  # Returns: Pair of identifiers of the thread and process_id that created the window.
+  #
+  #:call-seq:
+  #   thread, process_id = get_window_tread_process_id( win_handle )
+  #
+  def_api 'GetWindowThreadProcessId', 'LP', 'L' do |api, *args|
+    raise 'Invalid args count' unless args.size == api.prototype.size-1
+    thread = api.call(args.first, process = [1].pack('L'))
+    [thread, *process.unpack('L')]
+  end
+
+  ##
+  # Retrieves the dimensions of the specified window bounding rectangle.
+  #   Dimensions are given relative to the upper-left corner of the screen.
+  #
+  # Original Parameters:
+  #   win_handle (L) - Handle to the window.
+  #   rect (P) - Long pointer to a RECT structure that receives the screen coordinates of the upper-left and
+  #     lower-right corners of the window.
+  # Original Return Value: Nonzero indicates success. Zero indicates failure. For error info, call GetLastError.
+  #
   # API improved to accept only window handle and return 4-member dimensions array (left, top, right, bottom)
-  # handle (L) - Handle to the window, rectangle - pointer to 4-long array for coordinates
+  #
+  # New Parameters:
+  #   win_handle (L) - Handle to the window
+  # New Return: Array(left, top, right, bottom) - rectangle dimensions
   #
   # Remarks: As a convention for the RECT structure, the bottom-right coordinates of the returned rectangle
   #   are exclusive. In other words, the pixel at (right, bottom) lies immediately outside the rectangle.
   #
+  #:call-seq:
+  #   rect = get_window_rect( win_handle )
+  #
   def_api 'GetWindowRect', 'LP', 'I' do |api, *args|
     raise 'Invalid args count' unless args.size == api.prototype.size-1
     rectangle = [0, 0, 0, 0].pack 'L*'
     api.call args.first, rectangle
-    rectangle.unpack 'l*'
+    rectangle.unpack 'L*'
   end
 
-  def_api 'keybd_event', 'IILL', 'V'
-  def_api 'PostMessage', 'LLLL', 'L'
-  def_api 'SendMessage', 'LLLP', 'L'
-  def_api 'GetDlgItem', 'LL', 'L'
-
+  ##
   # The EnumWindows function enumerates all top-level windows on the screen by passing the handle to
   #   each window, in turn, to an application-defined callback function. EnumWindows continues until
   #   the last top-level window is enumerated or the callback function returns FALSE.
+  #
+  # Original Parameters:
+  #   callback [K] - Pointer to an application-defined callback function (see EnumWindowsProc).
+  #   message [P] - Specifies an application-defined value(message) to be passed to the callback function.
+  # Original Return: Nonzero if the function succeeds, zero if the function fails. GetLastError for error info.
+  #   If callback returns zero, the return value is also zero. In this case, the callback function should
+  #   call SetLastError to obtain a meaningful error code to be returned to the caller of EnumWindows.
+  #
   # API improved to accept blocks (instead of callback objects) and message as a single arg
-  # callback [K] - Pointer to an application-defined callback function (see EnumWindowsProc).
-  # message [P] - Specifies an application-defined value(message) to be passed to the callback function.
-  # Returns: Nonzero if the function succeeds, zero if the function fails (GetLastError for more error info).
+  #
+  # New Parameters:
+  #   message [P] - Specifies an application-defined value(message) to be passed to the callback function.
+  #   block given to method invocation serves as an application-defined callback function (see EnumWindowsProc).
+  # Returns: True if the function succeeds, false if the function fails. GetLastError for error info.
   #   If callback returns zero, the return value is also zero. In this case, the callback function should
   #   call SetLastError to obtain a meaningful error code to be returned to the caller of EnumWindows.
   #
@@ -205,23 +326,46 @@ module WinGui
   #   the GetWindow function in a loop. An application that calls GetWindow to perform this task risks being
   #   caught in an infinite loop or referencing a handle to a window that has been destroyed.
   #
-  def_api 'EnumWindows', 'KP', 'L', &return_enum
+  #:call-seq:
+  #   status = enum_windows( message ) {|win_handle, message| callback procedure }
+  #
+  def_api'EnumWindows', 'KP', 'L', boolean: true, &return_enum
 
+  ##
   # Enumerates child windows to a given window.
-  # parent (L) - Handle to the parent window whose child windows are to be enumerated.
+  #
+  # Original Parameters:
+  #   parent (L) - Handle to the parent window whose child windows are to be enumerated.
+  #   callback [K] - Pointer to an application-defined callback function (see EnumWindowsProc).
+  #   message [P] - Specifies an application-defined value(message) to be passed to the callback function.
+  # Original Return: Not used (?!)
+  #   If callback returns zero, the return value is also zero. In this case, the callback function should
+  #   call SetLastError to obtain a meaningful error code to be returned to the caller of EnumWindows.
   #   If it is nil, this function is equivalent to EnumWindows. Windows 95/98/Me: parent cannot be NULL.
+  #
   # API improved to accept blocks (instead of callback objects) and two args: parent handle and message.
-  # callback (K) - Pointer to an application-defined callback function (see EnumChildProc).
-  # message (P) - Specifies an application-defined value(message) to be passed to the callback function.
-  # Returns (L) -  Not used (?!)
+  # New Parameters:
+  #   parent (L) - Handle to the parent window whose child windows are to be enumerated.
+  #   message (P) - Specifies an application-defined value(message) to be passed to the callback function.
+  #   block given to method invocation serves as an application-defined callback function (see EnumChildProc).
+  #
+  # Remarks:
   #   If a child window has created child windows of its own, EnumChildWindows enumerates those windows as well.
   #   A child window that is moved or repositioned in the Z order during the enumeration process will be properly enumerated.
   #   The function does not enumerate a child window that is destroyed before being enumerated or that is created during the enumeration process.
+  #
+  #:call-seq:
+  #   enum_windows( parent_handle, message ) {|win_handle, message| callback procedure }
   def_api 'EnumChildWindows', 'LKP', 'L', &return_enum
 
   def_api 'GetForegroundWindow', 'V', 'L'
   def_api 'GetActiveWindow', 'V', 'L'
 
+  def_api 'keybd_event', 'IILL', 'V'
+  def_api 'PostMessage', 'LLLL', 'L'
+  def_api 'SendMessage', 'LLLP', 'L'
+  def_api 'GetDlgItem', 'LL', 'L'
+
 
   # Convenience wrapper methods:
 

data/spec/spec_helper.rb

@@ -1,9 +1,9 @@
-lib_dir = File.join(File.dirname(__FILE__),".." ,"lib" )
+lib_dir = File.join(File.dirname(__FILE__), "..", "lib" )
 $LOAD_PATH.unshift lib_dir unless $LOAD_PATH.include?(lib_dir)
 require 'spec'
 require 'win_gui'
 require 'note'
-                                        
+
 # Customize RSpec with my own extensions
 module SpecMacros
 
@@ -15,9 +15,9 @@ module SpecMacros
 
   # reads description line from source file and drops external brackets (like its{}, use{}
   def description_from(file, line)
-      File.open(file) do |f|
-        f.lines.to_a[line-1].gsub( /(spec.*?{)|(use.*?{)|}/, '' ).strip
-      end
+    File.open(file) do |f|
+      f.lines.to_a[line-1].gsub( /(spec.*?{)|(use.*?{)|}/, '' ).strip
+    end
   end
 end
 
@@ -45,8 +45,9 @@ module GuiTest
   def use
     lambda {yield}.should_not raise_error
   end
-  
+
   def any_handle
+    WinGui.def_api 'FindWindow', 'PP', 'L' unless respond_to? :find_window
     find_window(nil, nil)
   end
 
@@ -57,48 +58,54 @@ module GuiTest
   def any_block
     lambda {|*args| args}
   end
-  
-  def hide_method(name) # hide original method if it is defined
-    WinGui.module_eval do
-      if method_defined? name.to_sym
-        alias_method "orig_#{name.to_s}".to_sym, name.to_sym
-        remove_method name.to_sym
+
+  def hide_method(*names) # hide original method(s) if it is defined
+    names.each do |name|
+      WinGui.module_eval do
+        if method_defined? name.to_sym
+          alias_method "orig_#{name.to_s}".to_sym, name.to_sym
+          remove_method name.to_sym
+        end
       end
     end
   end
-  
-  def restore_method(name) # restore original method if it was hidden
-    WinGui.module_eval do
-      temp = "orig_#{name.to_s}".to_sym
-      if method_defined? temp
-        alias_method name.to_sym, temp
-        remove_method temp
+
+  def restore_method(*names) # restore original method if it was hidden
+    names.each do |name|
+      WinGui.module_eval do
+        temp = "orig_#{name.to_s}".to_sym
+        if method_defined? temp
+          alias_method name.to_sym, temp
+          remove_method temp
+        end
       end
     end
   end
-  
+
   def launch_test_app
     system TEST_APP_START
     sleep TEST_SLEEP_DELAY until (handle = find_window(nil, TEST_WIN_TITLE))
     @launched_test_app = Window.new handle
   end
-  
+
   def close_test_app(app = @launched_test_app)
     while app and app.respond_to? :handle and find_window(nil, TEST_WIN_TITLE)
       post_message(app.handle, WM_SYSCOMMAND, SC_CLOSE, 0)
       sleep TEST_SLEEP_DELAY
-    end  
+    end
     @launched_test_app = nil
   end
-  
+
   # Creates test app object and yields it back to the block
   def test_app
     app = launch_test_app
+
     def app.textarea #define singleton method retrieving app's text area
       Window.new find_window_ex(self.handle, 0, TEST_TEXTAREA_CLASS, nil)
     end
+
     yield app
-    close_test_app 
+    close_test_app
   end
-  
+
 end