uia 0.0.7.3 → 0.0.8

data/ChangeLog

@@ -1,3 +1,13 @@
+=== Version 0.0.8 / 2013-12-02
+*	Enhancements
+	*	Uia#find_element and Element#find can locate by :title
+	*	Element#send_keys
+	*	Window#close
+	*	TextPattern support to get / set the text
+
+*	Bug Fixes
+	*	Fix issue with selecting cells in a table
+
 === Version 0.0.7.3 / 2013-11-02
 *	Enhancements
 	*	Element#visible?

data/ext/UiaDll/UIA.Helper/Clicker.cs

@@ -23,7 +23,7 @@ namespace UIA.Helper
         public static void MouseClick(AutomationElement element)
         {
             element.ScrollToIfPossible();
-            element.SetFocus();
+            element.TryToFocus();
 
             var clickablePoint = element.GetClickablePoint();
             Cursor.Position = new System.Drawing.Point((int)clickablePoint.X, (int)clickablePoint.Y);

data/ext/UiaDll/UIA.Helper/Element.cs

@@ -22,6 +22,12 @@ namespace UIA.Helper
             return (TPattern) _element.GetCurrentPattern(pattern);
         }
 
+        public void SendKeys(string keysToSend)
+        {
+            _element.TryToFocus();
+            System.Windows.Forms.SendKeys.SendWait(keysToSend);
+        }
+
         public virtual int[] RuntimeId
         {
             get { return _element.GetRuntimeId(); }
@@ -97,6 +103,11 @@ namespace UIA.Helper
             return new Element(element);
         }
 
+        public static Element[] From(AutomationElement[] elements)
+        {
+            return elements.Select(x => new Element(x)).ToArray();
+        }
+
         public static Element ById(string automationId)
         {
             return FindFirst(automationId.IdCondition());

data/ext/UiaDll/UIA.Helper/Extensions.cs

@@ -30,6 +30,14 @@ namespace UIA.Helper
 
     public static class ElementExtensions
     {
+        public static bool TryToFocus(this AutomationElement automationElement)
+        {
+            try
+            {
+                automationElement.SetFocus();
+                return true;
+            } catch { return false; }
+        }
 
         public static bool ScrollToIfPossible(this AutomationElement automationElement)
         {

data/ext/UiaDll/UiaDll/ElementMethods.cpp

@@ -15,10 +15,6 @@ extern "C" {
     delete elementInformation;
   }
 
-  __declspec(dllexport) void Element_ReleaseMany(ElementsPtr elements) {
-    delete elements;
-  }
-
   __declspec(dllexport) void Element_Refresh(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
       element->Refresh(Find(element));
@@ -27,6 +23,14 @@ extern "C" {
     }
   }
 
+  __declspec(dllexport) void Element_SendKeys(ElementInformationPtr element, const char* keysToSend, char* errorInfo, const int errorInfoLength) {
+    try {
+      Find(element)->SendKeys(gcnew String(keysToSend));
+    } catch(Exception^ e) {
+      StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
+    }
+  }
+
   __declspec(dllexport) ElementInformationPtr Element_FindById(const char* automationId, char* errorInfo, const int errorLength) {
     try {
       return ElementInformation::From(Element::ById(gcnew String(automationId)));

data/ext/UiaDll/UiaDll/ElementStructures.h

@@ -65,26 +65,3 @@ private:
   }
 
 } ElementInformation, *ElementInformationPtr;
-
-typedef struct _Elements {
-  int length;
-  ElementInformation* elements;
-
-  _Elements() : length(0), elements(NULL) {}
-
-  _Elements(array<Element^>^ elements) : length(0), elements(NULL) {
-    if( nullptr == elements ) return;
-
-    length = elements->Length;
-    if( length > 0 ) this->elements = new ElementInformation[length];
-
-    auto index = 0;
-    for each(auto element in elements) {
-      this->elements[index++].Refresh(element);
-    }
-  }
-
-  ~_Elements() {
-    delete[] elements;
-  }
-} Elements, *ElementsPtr;

data/ext/UiaDll/UiaDll/PatternInformationStructures.h

@@ -127,31 +127,11 @@ private:
 typedef struct _TableInformation {
   int RowCount;
   int ColumnCount;
-  ElementsPtr Headers;
-
-  _TableInformation(int rowCount, int columnCount, ...array<Element^> ^headers) {
-    init(rowCount, columnCount, headers);
-  }
 
   _TableInformation(TablePattern::TablePatternInformation^ tableInfo) {
-    auto headers = tableInfo->GetColumnHeaders();
-    auto toElementFunc = gcnew Func<AutomationElement^, Element^>(Element::From);
-
-    init(tableInfo->RowCount, tableInfo->ColumnCount, Enumerable::ToArray(Enumerable::Select<AutomationElement^, Element^>(headers, toElementFunc)));
-  }
-
-  ~_TableInformation() {
-    delete Headers;
+    RowCount = tableInfo->RowCount;
+    ColumnCount = tableInfo->ColumnCount;
   }
-
-private:
-  void init(int rowCount, int columnCount, ...array<Element^> ^headers) {
-    RowCount = rowCount;
-    ColumnCount = columnCount;
-
-    Headers = new Elements(headers);
-  }
-
 } TableInformation, *TableInformationPtr;
 
 typedef struct _TableItemInformation {

data/ext/UiaDll/UiaDll/TableMethods.cpp

@@ -13,4 +13,15 @@ extern "C" {
       return NULL;
     }
   }
+
+  __declspec(dllexport) int Table_Headers(ElementInformationPtr element, ElementInformation** headers, char* errorInfo, const int errorInfoLength) {
+    try {
+      auto headerElements = Find(element)->As<TablePattern^>(TablePattern::Pattern)->Current.GetColumnHeaders();
+      *headers = ElementInformation::From(Element::From(headerElements));
+      return headerElements->Length;
+    } catch(Exception^ e) {
+      StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
+      return 0;
+    }
+  }
 }

data/ext/UiaDll/UiaDll/TextMethods.cpp

@@ -0,0 +1,17 @@
+#include "Stdafx.h"
+
+extern "C" {
+  __declspec(dllexport) int Text_GetText(ElementInformationPtr element, char* text, const int textLength, char* errorInfo, const int errorInfoLength) {
+    try {
+      auto theText = Find(element)->As<TextPattern^>(TextPattern::Pattern)->DocumentRange->GetText(-1);
+      if( NULL != text ) {
+        StringHelper::CopyToUnmanagedString(theText, text, textLength);
+      }
+
+      return theText->Length;
+    } catch(Exception^ e) {
+      StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
+      return 0;
+    }
+  }
+}

data/ext/UiaDll/UiaDll/UiaDll.cpp

@@ -5,5 +5,11 @@ extern "C" {
   __declspec(dllexport) void initialize(char* privateAssemblyDirectory) {
     DynamicAssemblyResolver::PrivatePath = gcnew String(privateAssemblyDirectory);
   }
+
+  __declspec(dllexport) void Automation_WarmUp() {
+    try {
+      auto warmed = Element::Windows;
+    } catch(Exception^) {}
+  }
 }
 

data/ext/UiaDll/UiaDll/UiaDll.vcxproj

@@ -101,6 +101,7 @@
     </ClCompile>
     <ClCompile Include="TableItemMethods.cpp" />
     <ClCompile Include="TableMethods.cpp" />
+    <ClCompile Include="TextMethods.cpp" />
     <ClCompile Include="ToggleMethods.cpp" />
     <ClCompile Include="UiaDll.cpp" />
     <ClCompile Include="ValuePatternMethods.cpp" />

data/ext/UiaDll/UiaDll/UiaDll.vcxproj.filters

@@ -83,5 +83,8 @@
     <ClCompile Include="RangeValueMethods.cpp">
       <Filter>Source Files\Patterns</Filter>
     </ClCompile>
+    <ClCompile Include="TextMethods.cpp">
+      <Filter>Source Files\Patterns</Filter>
+    </ClCompile>
   </ItemGroup>
 </Project>

data/ext/UiaDll/UiaDll/WindowMethods.cpp

@@ -21,4 +21,12 @@ extern "C" {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
   }
+
+  __declspec(dllexport) void Window_Close(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
+    try {
+      Find(element)->As<WindowPattern^>(WindowPattern::Pattern)->Close();
+    } catch(Exception^ e) {
+      StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
+    }
+  }
 }

data/ext/UiaDll/UiaDll.Test/PatternInformationTest.cpp

@@ -41,8 +41,3 @@ TEST(WindowInformation, CanBeInitialized) {
   ASSERT_STREQ("Minimized", windowInformation.VisualState);
   ASSERT_STREQ("Closing", windowInformation.InteractionState);
 }
-
-TEST(TableInformation, NullHeadersYieldsEmptyElements) {
-  auto tableInformation = TableInformation(0, 0, nullptr);
-  ASSERT_EQ(0, tableInformation.Headers->length);
-}

data/ext/UiaDll/UiaDll.Test/UiaDll.Test.vcxproj

@@ -105,7 +105,6 @@
   <ItemGroup>
     <ClCompile Include="AssemblyInfo.cpp" />
     <ClCompile Include="ElementInformationTest.cpp" />
-    <ClCompile Include="ElementsTest.cpp" />
     <ClCompile Include="PatternInformationTest.cpp" />
     <ClCompile Include="stdafx.cpp">
       <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">Create</PrecompiledHeader>

data/ext/UiaDll/UiaDll.Test/UiaDll.Test.vcxproj.filters

@@ -52,9 +52,6 @@
     <ClCompile Include="ElementInformationTest.cpp">
       <Filter>Source Files</Filter>
     </ClCompile>
-    <ClCompile Include="ElementsTest.cpp">
-      <Filter>Source Files</Filter>
-    </ClCompile>
     <ClCompile Include="StringHelperTest.cpp">
       <Filter>Source Files</Filter>
     </ClCompile>

data/lib/core_ext/symbol.rb

@@ -2,4 +2,11 @@ class Symbol
   def to_camelized_s
     self.to_s.split('_').map(&:capitalize).join(' ')
   end
+
+  # :selection_item => Uia::Patterns::SelectionItem
+  def to_pattern_const
+    "Uia::Patterns::#{self.to_s.capitalize}".split('::').reduce(Object) do |m, current|
+      m.const_get current.split('_').map(&:capitalize).join
+    end
+  end
 end

data/lib/uia/element.rb

@@ -1,5 +1,6 @@
 require 'uia/library/element_attributes'
 require 'uia/library/pattern_info_attributes'
+require 'uia/keys'
 
 module Uia
   class UnsupportedPattern < StandardError
@@ -9,6 +10,7 @@ module Uia
   end
 
   class Element
+    include Finder
     extend ElementAttributes
 
     def initialize(element)
@@ -24,20 +26,17 @@ module Uia
       Library::Constants::ControlTypes.find(@default) { |_, v| v == @element.control_type_id }.first
     end
 
+    def send_keys(*keys)
+      Library.send_keys @element, Keys.encode(keys)
+    end
+
     def refresh
       Library.refresh @element
       self
     end
 
     def find(locator)
-      scope = (locator[:scope] || :descendants).to_s.capitalize
-
-      case
-        when locator[:id]
-          Library::find_child_by_id(@element, locator[:id], scope)
-        when locator[:name]
-          Library::find_child_by_name(@element, locator[:name], scope)
-      end
+      find_child(@element, locator)
     end
 
     def locators_match?(locator)
@@ -51,17 +50,13 @@ module Uia
       end
     end
 
-    def select(locator)
+    def filter(locator)
       descendants.select { |e| e.locators_match? locator }
     end
 
     def as(pattern)
       raise UnsupportedPattern.new(pattern, patterns) unless patterns.include? pattern
-
-      which = "Uia::Patterns::#{pattern.to_s.capitalize}".split('::').reduce(Object) do |m, current|
-        m.const_get current.split('_').map(&:capitalize).join
-      end
-      extend which
+      extend pattern.to_pattern_const
     end
 
     def patterns

data/lib/uia/finder.rb

@@ -1,13 +1,66 @@
+require 'uia/library/win32'
+
 module Uia
+  class BadLocator < StandardError
+    def initialize(locator)
+      super "#{locator} is not a valid locator"
+    end
+  end
+  class BadChildLocator < BadLocator; end
+
   module Finder
+    def find_from_root(locator)
+      case
+        when locator[:id]
+          find_by_id locator[:id]
+        when locator[:name], locator[:value]
+          find_by_name locator[:name] || locator[:value]
+        when locator[:pid]
+          find_by_pid locator[:pid]
+        when locator[:runtime_id]
+          find_by_runtime_id locator[:runtime_id]
+        when locator[:handle]
+          find_by_handle locator[:handle]
+        when locator[:title]
+          find_by_title locator[:title]
+        else
+          raise BadLocator, locator
+      end
+    end
+
+    def find_child(parent, locator)
+      scope = (locator[:scope] || :descendants).to_s.capitalize
+
+      case
+        when locator[:id]
+          find_child_by_id parent, locator[:id], scope
+        when locator[:name], locator[:value]
+          name_or_value = locator[:name] || locator[:value]
+          find_child_by_name parent, name_or_value, scope
+        when locator[:title]
+          find_by_title locator[:title], parent.handle
+        else
+          raise BadChildLocator, locator
+      end
+    end
+
+    private
     def find_by_id(id)
       find_by_property(:id, id)
     end
 
+    def find_child_by_id(parent, id, scope)
+      Library.find_child_by_id(parent, id, (scope || :descendants).to_s.capitalize)
+    end
+
     def find_by_name(name)
       find_by_property(:name, name)
     end
 
+    def find_child_by_name(parent, name, scope)
+      Library.find_child_by_name(parent, name, (scope || :descendants).to_s.capitalize)
+    end
+
     def find_by_pid(pid)
       Library.find_by_pid(pid)
     end
@@ -20,7 +73,20 @@ module Uia
       Library.find_by_handle handle
     end
 
-    private
+    def find_by_title(title, parent=0)
+      found_window = Win32.find_window(parent) do |handle|
+        case title
+          when Regexp
+            Win32.window_title(handle) =~ title
+          else
+            Win32.window_title(handle) == title
+        end
+      end
+      find_by_handle found_window if found_window
+    rescue
+      nil
+    end
+
     def find_by_property(property, what)
       case what
         when String

data/lib/uia/keys.rb

@@ -0,0 +1,76 @@
+module Uia
+  class InvalidKey < StandardError; end
+  class Keys
+    # http://msdn.microsoft.com/en-us/library/system.windows.forms.sendkeys(v=vs.110).aspx
+    KEYS = {
+        :shift => '+',
+        :control => '^',
+        :alt => '%',
+        :space => ' ',
+        :backspace => '{BS}',
+        :break => '{BREAK}',
+        :caps_lock => '{CAPSLOCK}',
+        :delete => '{DEL}',
+        :down => '{DOWN}',
+        :end => '{END}',
+        :enter => '{ENTER}',
+        :escape => '{ESC}',
+        :help => '{HELP}',
+        :home => '{HOME}',
+        :insert => '{INS}',
+        :left => '{LEFT}',
+        :number_lock => '{NUMLOCK}',
+        :page_down => '{PGDN}',
+        :page_up => '{PGUP}',
+        :print_screen => '{PRTSC}',
+        :right => '{RIGHT}',
+        :scroll_lock => '{SCROLLLOCK}',
+        :tab => '{TAB}',
+        :up => '{UP}',
+        :f1 => '{F1}',
+        :f2 => '{F2}',
+        :f3 => '{F3}',
+        :f4 => '{F4}',
+        :f5 => '{F5}',
+        :f6 => '{F6}',
+        :f7 => '{F7}',
+        :f8 => '{F8}',
+        :f9 => '{F9}',
+        :f10 => '{F10}',
+        :f11 => '{F11}',
+        :f12 => '{F12}',
+        :f13 => '{F13}',
+        :f14 => '{F14}',
+        :f15 => '{F15}',
+        :f16 => '{F16}',
+        :add => '{ADD}',
+        :subtract => '{SUBTRACT}',
+        :multiply => '{MULTIPLY}',
+        :divide => '{DIVIDE}'}
+
+    SPECIAL_KEYS = ['\+', '\^', '%', '~', '\(', '\)', '\{', '\}', '\[', '\]']
+
+    def self.encode(keys)
+      keys.reduce('') do |encoded, key|
+        encoded << case key
+                     when String
+                       encode_str(key)
+                     when Symbol
+                       encode_sym(key)
+                     when Array
+                       "#{encode([key.shift])}(#{encode(key)})"
+                   end
+      end
+    end
+
+    def self.encode_str(s)
+      s.gsub(/([#{SPECIAL_KEYS.join ''}])/, '{\1}')
+    end
+
+    def self.encode_sym(sym)
+      found = KEYS[sym]
+      raise InvalidKey, "#{sym} is not a valid key" unless found
+      found
+    end
+  end
+end

data/lib/uia/library/element_structs.rb

@@ -63,17 +63,5 @@ module Uia
     class ElementStruct < FFI::Struct
       include ElementLayout
     end
-
-    class Elements < FFI::Struct
-      layout :length, :int,
-             :items, :pointer
-
-      def children
-        self[:length].times.collect do |i|
-          pointer = self[:items] + i * ElementStruct.size
-          Uia::Element.new(ElementStruct.new(pointer))
-        end
-      end
-    end
   end
 end

data/lib/uia/library/pattern_structs.rb

@@ -95,15 +95,10 @@ module Uia
       extend StructAttributes
 
       layout :row_count, :int,
-             :column_count, :int,
-             :headers, Elements.ptr
+             :column_count, :int
 
       struct_attr :row_count, :column_count
 
-      def headers
-        self[:headers].children
-      end
-
       def self.release(pointer)
         Library.release_table_info(pointer)
       end

data/lib/uia/library/win32.rb

@@ -0,0 +1,35 @@
+require 'ffi'
+
+module Win32
+  extend FFI::Library
+
+  ffi_lib 'user32'
+
+  callback :enum_callback, [:long, :long], :bool
+
+  attach_function :enum_child_windows, :EnumChildWindows,
+                  [:long, :enum_callback, :long], :long
+  attach_function :_window_title, :GetWindowTextA,
+                  [:long, :pointer, :int], :int
+  attach_function :window_title_length, :GetWindowTextLengthA,
+                  [:long], :int
+
+  class << self
+    def window_title(handle)
+      length = window_title_length(handle) + 1
+      title = FFI::MemoryPointer.new :char, length
+      _window_title handle, title, length
+      title.read_string
+    end
+
+    def find_window(parent, &block)
+      found_window = nil
+      window_callback = FFI::Function.new(:bool, [:long, :pointer], {convention: :stdcall}) do |handle, _|
+        found_window = handle if block.call handle
+        !found_window
+      end
+      Win32.enum_child_windows parent, window_callback, 0
+      found_window
+    end
+  end
+end

data/lib/uia/library.rb

@@ -16,6 +16,9 @@ module Uia
     attach_function :init, :initialize, [:string], :void
     init(uia_directory)
 
+    attach_function :warm_up_automation, :Automation_WarmUp, [], :void
+    warm_up_automation
+
     def self.attach_throwable_function(name_alias, name, arg_types, return_type, &block)
       attach_function name, arg_types + [:pointer, :int], return_type
       define_singleton_method(name_alias) do |*args|
@@ -62,6 +65,7 @@ module Uia
     attach_function :Element_FindByRuntimeId, [:pointer, :int, :pointer, :int], ManagedElementStruct.by_ref
 
     # element methods
+    attach_throwable_function :send_keys, :Element_SendKeys, [:pointer, :string], :void
     attach_throwable_function :find_child_by_id, :Element_FindChildById, [:pointer, :string, :string], ManagedElementStruct.by_ref, &element_or_nil
     attach_throwable_function :find_child_by_name, :Element_FindChildByName, [:pointer, :string, :string], ManagedElementStruct.by_ref, &element_or_nil
     elements_from :children, :Element_Children, [:pointer]
@@ -72,6 +76,7 @@ module Uia
     # WindowPattern methods
     attach_throwable_function :window_information, :Window_Information, [:pointer], WindowInformation.by_ref
     attach_throwable_function :set_visual_state, :Window_SetVisualState, [:pointer, :string], :void
+    attach_throwable_function :close_window, :Window_Close, [:pointer], :void
 
     # ValuePattern methods
     attach_throwable_function :set_value, :Value_Set, [:pointer, :string], :void
@@ -100,6 +105,7 @@ module Uia
 
     # TablePattern methods
     attach_throwable_function :table_info, :Table_Information, [:pointer], TableInformation.by_ref
+    elements_from :table_headers, :Table_Headers, [:pointer]
 
     # TableItemPattern methods
     attach_throwable_function :table_item_info, :TableItem_Information, [:pointer], TableItemInformation.by_ref
@@ -108,6 +114,16 @@ module Uia
     attach_throwable_function :range_value_info, :RangeValue_Information, [:pointer], RangeValueInformation.by_ref
     attach_throwable_function :set_range_value, :RangeValue_SetValue, [:pointer, :double], :void
 
+    # TextPattern methods
+    attach_function :Text_GetText, [:pointer, :pointer, :int, :pointer, :int], :int
+
+    def self.get_text(element)
+      length = can_throw(:Text_GetText, element, nil, 0) + 1
+      p = FFI::MemoryPointer.new :pointer, length
+      can_throw(:Text_GetText, element, p, length)
+      p.read_string
+    end
+
     def self.find_by_runtime_id(id)
       p = FFI::MemoryPointer.new :int, id.count
       p.write_array_of_int(id)

data/lib/uia/patterns/selection.rb

@@ -2,7 +2,7 @@ module Uia
   module Patterns
     module Selection
       def selection_items
-        select(pattern: :selection_item).map {|e| e.as :selection_item }
+        filter(pattern: :selection_item).map {|e| e.as :selection_item }
       end
 
       def multi_select?

data/lib/uia/patterns/table.rb

@@ -3,7 +3,7 @@ module Uia
     module Table
       module Row
         def items
-          select(pattern: :table_item).each { |e| e.as :table_item }
+          filter(pattern: :table_item).each { |e| e.as :table_item }
         end
       end
 
@@ -16,11 +16,11 @@ module Uia
       end
 
       def headers
-        table_info.headers
+        Library.table_headers @element
       end
 
       def rows
-        select(control_type: :data_item).each { |e| e.extend Row }
+        filter(control_type: :data_item).each { |e| e.extend Row }
       end
 
       private

data/lib/uia/patterns/text.rb

@@ -0,0 +1,13 @@
+module Uia
+  module Patterns
+    module Text
+      def text=(value)
+        send_keys [:control, :home], [:control, :shift, :end], value
+      end
+
+      def text
+        Library.get_text @element
+      end
+    end
+  end
+end

data/lib/uia/patterns/window.rb

@@ -1,6 +1,10 @@
 module Uia
   module Patterns
     module Window
+      def close
+        Library.close_window @element
+      end
+
       def visual_state
         window_information.visual_state.to_snake_case_sym
       end

data/lib/uia/version.rb

@@ -1,3 +1,3 @@
-module Uia
-  VERSION = '0.0.7.3'
-end
+module Uia
+  VERSION = '0.0.8'
+end

data/lib/uia.rb

@@ -9,7 +9,6 @@ require_rel 'uia/patterns'
 require_rel 'core_ext'
 
 module Uia
-  class BadLocator < StandardError; end
   extend Finder
 
   def self.children
@@ -17,19 +16,6 @@ module Uia
   end
 
   def self.find_element(how)
-    case
-      when how[:id]
-        find_by_id how[:id]
-      when how[:name]
-        find_by_name how[:name]
-      when how[:pid]
-        find_by_pid how[:pid]
-      when how[:runtime_id]
-        find_by_runtime_id how[:runtime_id]
-      when how[:handle]
-        find_by_handle how[:handle]
-      else
-        raise BadLocator, "#{how} is not a valid locator"
-    end
+    find_from_root(how)
   end
 end

data/spec/spec_helper.rb

@@ -9,6 +9,16 @@ require 'uia'
 
 include Uia
 
+def wait_until(timeout=10, &block)
+  start = Time.now
+  until (result = block.call) || (Time.now - start > timeout)
+    sleep 0.25
+  end
+
+  raise 'Timed out' unless result
+  result
+end
+
 RSpec.configure do |config|
   config.before(:all) do
     @app = ChildProcess.build('spec/app/WindowsForms.exe').start

data/spec/uia/element_spec.rb

@@ -1,8 +1,8 @@
 require 'spec_helper'
 
 describe Uia::Element do
-  Given(:element) { Uia.find_element(id: 'MainFormWindow') }
-  Given(:about_box) { Uia.find_element(id: 'AboutBox') }
+  Given(:element) { wait_until { Uia.find_element(id: 'MainFormWindow') } }
+  Given(:about_box) { wait_until { Uia.find_element(id: 'AboutBox') } }
   Given { element.as(:window).visual_state = :normal }
 
   context 'properties' do
@@ -54,15 +54,31 @@ describe Uia::Element do
     end
   end
 
+  context '#send_keys' do
+    Given(:text_field) { element.find(id: 'textField').as :value }
+    When { text_field.send_keys 'abcde', [:left] * 3, ' fgh ' }
+    Then { text_field.value == 'ab fgh cde'}
+  end
+
   context '#find' do
     context 'id' do
       Then { element.find(id: 'textField') != nil }
       Then { element.find(id: 'does not exist') == nil }
     end
 
-    context 'name' do
+    context 'name, value' do
       Then { element.find(name: 'No option selected') != nil }
       Then { element.find(name: 'does not exist') == nil }
+      Then { element.find(value: 'No option selected') != nil }
+    end
+
+    context 'title' do
+      Then { element.find(title: /Group.*of radio/i) != nil }
+    end
+
+    context 'invalid' do
+      When(:bad_locator) { element.find(bad_locator: 123) }
+      Then { bad_locator.should have_failed BadLocator, "{:bad_locator=>123} is not a valid locator" }
     end
 
     context 'limiting scope' do
@@ -72,16 +88,16 @@ describe Uia::Element do
 
   context '#select' do
     context 'control_type' do
-      When(:buttons) { element.select(control_type: :radio_button) }
+      When(:buttons) { element.filter(control_type: :radio_button) }
       Then { buttons.map(&:control_type) == [:radio_button] * 3 }
     end
 
     context 'pattern' do
-      Then { element.select(pattern: :value).count == 4 }
+      Then { element.filter(pattern: :value).count == 4 }
     end
 
     context 'combinations' do
-      Then { element.select(control_type: :button, name: 'About')[0].id == 'aboutButton' }
+      Then { element.filter(control_type: :button, name: 'About')[0].id == 'aboutButton' }
     end
   end
 
@@ -94,11 +110,6 @@ describe Uia::Element do
       Then { about_box != nil }
       And { about_box.children.find { |c| c.name == 'OK' }.click }
     end
-
-    context 'disabled elements' do
-      When(:click_disabled) { disabled_checkbox.click }
-      Then { click_disabled.should have_failed('Target element cannot receive focus.') }
-    end
   end
 
   context '#children' do

data/spec/uia/keys_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe Uia::Keys do
+  def encode(*keys)
+    Keys.encode keys
+  end
+
+  Then { encode('Bacon sandwich') == 'Bacon sandwich' }
+  Then { encode([:control, :shift, 'a']) == '^(+a)' }
+
+  context 'special keys' do
+    Then { encode(:shift, :f2, :left) == '+{F2}{LEFT}' }
+  end
+
+  context 'special characters' do
+    Then { encode('1 + 2') == '1 {+} 2' }
+    Then { encode('1 ^^ 2') == '1 {^}{^} 2' }
+    Then { encode('a%b') == 'a{%}b' }
+    Then { encode('~ish') == '{~}ish' }
+    Then { encode('(1 - 2)') == '{(}1 - 2{)}' }
+    Then { encode('{DUDE}') == '{{}DUDE{}}' }
+    Then { encode('[DUDE]') == '{[}DUDE{]}' }
+    Then { encode('(Bacon + sand%wich^ [sweet] {}') == '{(}Bacon {+} sand{%}wich{^} {[}sweet{]} {{}{}}' }
+  end
+
+  context 'invalid' do
+    When(:bad_keys) { encode('something', :bad_key) }
+    Then { bad_keys.should have_failed InvalidKey, "#{:bad_key} is not a valid key" }
+  end
+end

data/spec/uia/patterns/text_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe Uia::Patterns::Text do
+  Given(:text_field) do
+    Uia.find_element(id: 'MainFormWindow').children.find { |e| e.id == 'multiLineTextField' }.as :text
+  end
+
+  context '#text' do
+    context 'getting / setting' do
+      When { text_field.text = '{text} to be expected!' }
+      Then { text_field.text == '{text} to be expected!' }
+    end
+
+    context 'updating' do
+      Given { text_field.text = 'about to be overwritten' }
+      When { text_field.text = 'expected update' }
+      Then { text_field.text == 'expected update' }
+    end
+  end
+end

data/spec/uia/patterns/window_spec.rb

@@ -28,4 +28,18 @@ describe Uia::Patterns::Window do
       Then { window.visual_state == :normal }
     end
   end
+
+  context '#close' do
+    def notepad_window
+      Uia.find_element(title: /^Untitled.*Notepad/i)
+    end
+
+    Given(:notepad) do
+      ChildProcess.build('notepad.exe').start
+      wait_until { notepad_window }.as :window
+    end
+    When { notepad.close }
+    Then { notepad_window == nil }
+  end
+
 end

data/spec/uia_spec.rb

@@ -14,9 +14,10 @@ describe Uia do
       Then { Uia.find_element(id: 'not there') == nil }
     end
 
-    context 'by name' do
+    context 'by name / value' do
       Then { expect(Uia.find_element(name: 'MainFormWindow')).to be_instance_of(Element) }
-      Then { expect(Uia.find_element(name: /[Mm]ain.*Window/ )).to be_instance_of(Element) }
+      Then { expect(Uia.find_element(name: /[Mm]ain.*Window/)).to be_instance_of(Element) }
+      Then { expect(Uia.find_element(value: /[Mm]ain.*Window/)).to be_instance_of(Element) }
       Then { Uia.find_element(name: 'not there') == nil }
     end
 
@@ -39,6 +40,12 @@ describe Uia do
       Then { expect { Uia.find_element(handle: 0x0) }.to raise_error }
     end
 
+    context 'by title' do
+      Then { expect(Uia.find_element(title: 'MainFormWindow')).to be_instance_of(Element) }
+      Then { expect(Uia.find_element(title: /Main[Ff]orm/)).to be_instance_of(Element) }
+      Then { Uia.find_element(title: 'probably will not find') == nil }
+    end
+
     context 'invalid locators' do
       When(:bad_input) { Uia.find_element(bad: 123) }
       Then { bad_input.should have_failed(Uia::BadLocator, '{:bad=>123} is not a valid locator') }

data/uia.gemspec

@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'ffi'
+  spec.add_runtime_dependency 'ffi', '1.9.0'
   spec.add_runtime_dependency 'require_all'
 
   spec.add_development_dependency 'bundler', '~> 1.3'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: uia
 version: !ruby/object:Gem::Version
-  version: 0.0.7.3
+  version: 0.0.8
   prerelease: 
 platform: ruby
 authors:
@@ -9,24 +9,24 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-02 00:00:00.000000000 Z
+date: 2013-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.9.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.9.0
 - !ruby/object:Gem::Dependency
   name: require_all
   requirement: !ruby/object:Gem::Requirement
@@ -147,7 +147,6 @@ files:
 - ext/UiaDll/UiaDll.Test/AssemblyInfo.cpp
 - ext/UiaDll/UiaDll.Test/ElementInformationTest.cpp
 - ext/UiaDll/UiaDll.Test/ElementStub.h
-- ext/UiaDll/UiaDll.Test/ElementsTest.cpp
 - ext/UiaDll/UiaDll.Test/MemoryLeakDetector.h
 - ext/UiaDll/UiaDll.Test/PatternInformationTest.cpp
 - ext/UiaDll/UiaDll.Test/ReadMe.txt
@@ -179,6 +178,7 @@ files:
 - ext/UiaDll/UiaDll/StringHelper.h
 - ext/UiaDll/UiaDll/TableItemMethods.cpp
 - ext/UiaDll/UiaDll/TableMethods.cpp
+- ext/UiaDll/UiaDll/TextMethods.cpp
 - ext/UiaDll/UiaDll/ToggleMethods.cpp
 - ext/UiaDll/UiaDll/UiaDll.cpp
 - ext/UiaDll/UiaDll/UiaDll.h
@@ -192,6 +192,7 @@ files:
 - lib/uia.rb
 - lib/uia/element.rb
 - lib/uia/finder.rb
+- lib/uia/keys.rb
 - lib/uia/library.rb
 - lib/uia/library/constants.rb
 - lib/uia/library/element_attributes.rb
@@ -199,6 +200,7 @@ files:
 - lib/uia/library/pattern_info_attributes.rb
 - lib/uia/library/pattern_structs.rb
 - lib/uia/library/struct_attributes.rb
+- lib/uia/library/win32.rb
 - lib/uia/patterns/expand_collapse.rb
 - lib/uia/patterns/invoke.rb
 - lib/uia/patterns/range_value.rb
@@ -206,6 +208,7 @@ files:
 - lib/uia/patterns/selection_item.rb
 - lib/uia/patterns/table.rb
 - lib/uia/patterns/table_item.rb
+- lib/uia/patterns/text.rb
 - lib/uia/patterns/toggle.rb
 - lib/uia/patterns/value.rb
 - lib/uia/patterns/window.rb
@@ -215,6 +218,7 @@ files:
 - spec/app/WindowsForms.exe
 - spec/spec_helper.rb
 - spec/uia/element_spec.rb
+- spec/uia/keys_spec.rb
 - spec/uia/patterns/expand_collapse_spec.rb
 - spec/uia/patterns/invoke_spec.rb
 - spec/uia/patterns/range_value_spec.rb
@@ -222,6 +226,7 @@ files:
 - spec/uia/patterns/selection_spec.rb
 - spec/uia/patterns/table_item_spec.rb
 - spec/uia/patterns/table_spec.rb
+- spec/uia/patterns/text_spec.rb
 - spec/uia/patterns/toggle_spec.rb
 - spec/uia/patterns/value_spec.rb
 - spec/uia/patterns/window_spec.rb
@@ -244,7 +249,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 100309903
+      hash: 720468909
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -253,7 +258,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 100309903
+      hash: 720468909
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -266,6 +271,7 @@ test_files:
 - spec/app/WindowsForms.exe
 - spec/spec_helper.rb
 - spec/uia/element_spec.rb
+- spec/uia/keys_spec.rb
 - spec/uia/patterns/expand_collapse_spec.rb
 - spec/uia/patterns/invoke_spec.rb
 - spec/uia/patterns/range_value_spec.rb
@@ -273,6 +279,7 @@ test_files:
 - spec/uia/patterns/selection_spec.rb
 - spec/uia/patterns/table_item_spec.rb
 - spec/uia/patterns/table_spec.rb
+- spec/uia/patterns/text_spec.rb
 - spec/uia/patterns/toggle_spec.rb
 - spec/uia/patterns/value_spec.rb
 - spec/uia/patterns/window_spec.rb

data/ext/UiaDll/UiaDll.Test/ElementsTest.cpp

@@ -1,22 +0,0 @@
-#include "stdafx.h"
-#include "ElementStub.h"
-#include <ElementStructures.h>
-
-class ElementsTest : public ::testing::Test {
-public:
-  array<Element^>^ ElementsWithNames(...array<String^>^ names) {
-    auto elements = gcnew array<Element^>(names->Length);
-    auto index = 0;
-    for each(auto name in names) {
-      elements[index++] = gcnew ElementStub(name);
-    }
-    return elements;
-  }
-};
-
-TEST_F(ElementsTest, ItCanBeInitialized)
-{
-  auto elements = Elements(ElementsWithNames("First", "Second"));
-  ASSERT_STREQ("First", elements.elements[0].name);
-  ASSERT_STREQ("Second", elements.elements[1].name);
-}