uia 0.1.3.1 → 0.2

data/ChangeLog

@@ -1,3 +1,8 @@
+=== Version 0.2
+*   Enhancements
+    *   added Element#find_all method to find multiple elements by locators
+    *   Table and SelectionItem utilize #find_all rather than #filter
+
 === Version 0.1.3.1 / 2014-04-29
 *   Bug Fixes
     *   fixed issue with non-fully referenced InvalidControlType class

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

@@ -17,6 +17,16 @@ namespace UIA.Helper
             _element = element;
         }
 
+        public static Element From(AutomationElement element)
+        {
+            return null == element ? null : new Element(element);
+        }
+
+        public static Element[] From(AutomationElement[] elements)
+        {
+            return elements.Select(x => new Element(x)).ToArray();
+        }
+
         public TPattern As<TPattern>(AutomationPattern pattern)
         {
             return (TPattern)_element.GetCurrentPattern(pattern);
@@ -102,11 +112,6 @@ namespace UIA.Helper
             get { return Find(TreeScope.Children, Condition.TrueCondition); }
         }
 
-        public Element[] ChildrenOf(AutomationPropertyCondition.Id id)
-        {
-            return Find(TreeScope.Children, AutomationPropertyCondition.From(id));
-        }
-
         public Element[] Descendants
         {
             get { return Find(TreeScope.Descendants, Condition.TrueCondition); }
@@ -122,14 +127,14 @@ namespace UIA.Helper
             Mouse.ClickCenter(_element);
         }
 
-        public static Element From(AutomationElement element)
+        public Element[] Find(TreeScope scope, Condition condition)
         {
-            return null == element ? null : new Element(element);
+            return Find(_element, scope, condition);
         }
 
-        public static Element[] From(AutomationElement[] elements)
+        public Element FindFirst(TreeScope scope, Condition condition)
         {
-            return elements.Select(x => new Element(x)).ToArray();
+            return NullOr(_element.FindFirst(scope, condition));
         }
 
         public static Element ById(string automationId)
@@ -142,11 +147,6 @@ namespace UIA.Helper
             return FindFirst(scope, automationId.IdCondition());
         }
 
-        public Element ChildWith(TreeScope scope, Condition condition)
-        {
-            return FindFirst(scope, condition);
-        }
-
         public static Element ByName(string name)
         {
             return FindFirst(new PropertyCondition(AutomationElement.NameProperty, name));
@@ -172,11 +172,6 @@ namespace UIA.Helper
             return FindFirst(new PropertyCondition(AutomationElement.RuntimeIdProperty, runtimeId), TreeScope.Descendants);
         }
 
-        private Element[] Find(TreeScope scope, Condition condition)
-        {
-            return Find(_element, scope, condition);
-        }
-
         private static Element[] Find(AutomationElement element, TreeScope scope, Condition condition)
         {
             return element.FindAll(scope, condition).Cast<AutomationElement>()
@@ -184,11 +179,6 @@ namespace UIA.Helper
                            .ToArray();
         }
 
-        private Element FindFirst(TreeScope scope, Condition condition)
-        {
-            return NullOr(_element.FindFirst(scope, condition));
-        }
-
         private static Element FindFirst(Condition condition, TreeScope scope = TreeScope.Children)
         {
             return NullOr(AutomationElement.RootElement.FindFirst(scope, condition));

data/ext/UiaDll/UiaDll/ConditionHelper.h

@@ -30,6 +30,8 @@ public:
       return ControlTypeConditions(searchCondition->numbers, searchCondition->numbersCount);
     } else if(searchCondition->IsString()) {
       value = gcnew String(searchCondition->string);
+    } else if(searchCondition->IsPatternAvailableProperty()) {
+      value = true;
     } else {
       value = searchCondition->number;
     }

data/ext/UiaDll/UiaDll/ConditionMethods.cpp

@@ -15,6 +15,16 @@ extern "C" {
     return new SearchCondition(AutomationElement::NameProperty->Id, name);
   }
 
+  __declspec(dllexport) SearchConditionPtr Condition_Pattern(const char* pattern, char* errorInfo, const int errorInfoLength) {
+    try {
+      auto patternPropertyId = dynamic_cast<AutomationProperty^>(AutomationElement::typeid->GetField(gcnew String(pattern))->GetValue(nullptr))->Id;
+      return new SearchCondition(patternPropertyId, true);
+    } catch(Exception^ e) {
+      StringHelper::CopyToUnmanagedString(String::Format("{0} is an invalid AutomationProperty", gcnew String(pattern)), errorInfo, errorInfoLength);
+      return NULL;
+    }
+  }
+
   __declspec(dllexport) SearchConditionPtr Condition_ControlType(const int n, const int arg0, ...) {
     va_list arguments;
     va_start(arguments, arg0);

data/ext/UiaDll/UiaDll/ElementMethods.cpp

@@ -4,21 +4,20 @@
 using namespace UIA::Helper;
 
 extern "C" {
-  Element^ Find(ElementInformationPtr element) {
+  Element^ ElementFrom(ElementInformationPtr element) {
     if( element->nativeWindowHandle > 0 ) {
       return Element::ByHandle(IntPtr(element->nativeWindowHandle));
     }
 
-    return Element::ByRuntimeId(ArrayHelper::ToArray(element->runtimeId, element->runtimeIdLength));
-  }
-
+  return Element::ByRuntimeId(ArrayHelper::ToArray(element->runtimeId, element->runtimeIdLength));
+}
   __declspec(dllexport) void Element_Release(ElementInformationPtr elementInformation) {
     delete elementInformation;
   }
 
   __declspec(dllexport) void Element_Refresh(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      element->Refresh(Find(element));
+      element->Refresh(ElementFrom(element));
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
@@ -26,16 +25,16 @@ extern "C" {
 
   __declspec(dllexport) void Element_SendKeys(ElementInformationPtr element, const char* keysToSend, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->SendKeys(gcnew String(keysToSend));
+      ElementFrom(element)->SendKeys(gcnew String(keysToSend));
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
   }
 
-  ElementInformationPtr ManagedFindByConditions(ElementInformationPtr element, const char* treeScope, list<SearchConditionPtr>& conditions, char* errorInfo, const int errorInfoLength) {
+  ElementInformationPtr ManagedFindFirst(ElementInformationPtr element, const char* treeScope, list<SearchConditionPtr>& conditions, char* errorInfo, const int errorInfoLength) {
     try {
       auto scope = (TreeScope) Enum::Parse(TreeScope::typeid, gcnew String(treeScope));
-      return ElementInformation::From(Find(element)->ChildWith(scope, ConditionHelper::ConditionFrom(conditions)));
+      return ElementInformation::From(ElementFrom(element)->FindFirst(scope, ConditionHelper::ConditionFrom(conditions)));
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
@@ -43,7 +42,33 @@ extern "C" {
     return NULL;
   }
 
-  __declspec(dllexport) ElementInformationPtr FindByConditions(ElementInformationPtr element, const char* treeScope, char* errorInfo, const int errorInfoLength, const int count, SearchConditionPtr arg0, ...) {
+  __declspec(dllexport) ElementInformationPtr FindFirst(ElementInformationPtr element, const char* treeScope, char* errorInfo, const int errorInfoLength, const int count, SearchConditionPtr arg0, ...) {
+    va_list arguments;
+    va_start(arguments, arg0);
+
+    list<SearchConditionPtr> conditions;
+    conditions.push_back(arg0);
+    for(auto index = 1; index < count; index++) {
+      conditions.push_back(va_arg(arguments, SearchConditionPtr));
+    }
+
+    return ManagedFindFirst(element, treeScope, conditions, errorInfo, errorInfoLength);
+  }
+
+  int ManagedFindAll(ElementInformationPtr element, ElementInformation** elements, const char* treeScope, list<SearchConditionPtr>& conditions, char* errorInfo, const int errorInfoLength) {
+    try {
+      auto scope = (TreeScope) Enum::Parse(TreeScope::typeid, gcnew String(treeScope));
+      auto foundElements = ElementFrom(element)->Find(scope, ConditionHelper::ConditionFrom(conditions));
+      *elements = ElementInformation::From(foundElements);
+      return foundElements->Length;
+    } catch(Exception^ e) {
+      StringHelper::CopyToUnmanagedString(e->Message + Environment::NewLine + e->StackTrace, errorInfo, errorInfoLength);
+    }
+
+    return 0;
+  }
+
+  __declspec(dllexport) int FindAll(ElementInformationPtr parent, ElementInformation** elements, const char* treeScope, char* errorInfo, const int errorInfoLength, const int count, SearchConditionPtr arg0, ...) {
     va_list arguments;
     va_start(arguments, arg0);
 
@@ -53,7 +78,7 @@ extern "C" {
       conditions.push_back(va_arg(arguments, SearchConditionPtr));
     }
 
-    return ManagedFindByConditions(element, treeScope, conditions, errorInfo, errorInfoLength);
+    return ManagedFindAll(parent, elements, treeScope, conditions, errorInfo, errorInfoLength);
   }
 
   __declspec(dllexport) ElementInformationPtr Element_FindById(const char* automationId, char* errorInfo, const int errorLength) {
@@ -119,7 +144,7 @@ extern "C" {
 
   __declspec(dllexport) int Element_Children(ElementInformationPtr parentElement, ElementInformation** children, char* errorInfo, const int errorLength) {
     try {
-      auto elements = Find(parentElement)->Children;
+      auto elements = ElementFrom(parentElement)->Children;
       *children = ElementInformation::From(elements);
       return elements->Length;
     } catch(Exception^ error) {
@@ -130,7 +155,7 @@ extern "C" {
 
   __declspec(dllexport) int Element_Descendants(ElementInformationPtr parentElement, ElementInformation** descendants, char* errorInfo, const int errorLength) {
     try {
-      auto elements = Find(parentElement)->Descendants;
+      auto elements = ElementFrom(parentElement)->Descendants;
       *descendants = ElementInformation::From(elements);
       return elements->Length;
     } catch(Exception^ error) {
@@ -141,7 +166,7 @@ extern "C" {
 
   __declspec(dllexport) void Element_ClickClickablePoint(ElementInformationPtr element, char* errorInfo, const int errorLength) {
     try {
-      Find(element)->ClickClickablePoint();
+      ElementFrom(element)->ClickClickablePoint();
     } catch(Exception^ error) {
       StringHelper::CopyToUnmanagedString(error->Message, errorInfo, errorLength);
     }
@@ -149,7 +174,7 @@ extern "C" {
 
   __declspec(dllexport) void Element_ClickCenter(ElementInformationPtr element, char* errorInfo, const int errorLength) {
     try {
-      Find(element)->ClickCenter();
+      ElementFrom(element)->ClickCenter();
     } catch(Exception^ error) {
       StringHelper::CopyToUnmanagedString(error->Message, errorInfo, errorLength);
     }
@@ -157,7 +182,7 @@ extern "C" {
 
   __declspec(dllexport) void Element_Focus(ElementInformationPtr element, char* errorInfo, const int errorLength) {
     try {
-      Find(element)->SetFocus();
+      ElementFrom(element)->SetFocus();
     } catch(Exception^ error) {
       StringHelper::CopyToUnmanagedString(error->Message, errorInfo, errorLength);
     }

data/ext/UiaDll/UiaDll/ElementStructures.h

@@ -13,6 +13,10 @@ typedef struct _SearchCondition {
   int* numbers;
   int numbersCount;
 
+  _SearchCondition(const int id) : string(NULL), numbers(NULL) {
+    Reset(id);
+  }
+
   _SearchCondition(const int id, const char* s) : string(NULL), numbers(NULL) {
     Reset(id);
 
@@ -46,6 +50,16 @@ typedef struct _SearchCondition {
     return NULL != string;
   }
 
+  bool IsPatternAvailableProperty() {
+    try {
+      auto automationProperty = System::Windows::Automation::AutomationProperty::LookupById(propertyId);
+      return automationProperty->ProgrammaticName->Contains("PatternAvailableProperty");
+    } catch(Exception^ e) {
+      Console::WriteLine(e->Message);
+      return false;
+    }
+  }
+
   static _SearchCondition* FromControlTypes(list<const int>& controlTypes) {
     return new SearchCondition(System::Windows::Automation::AutomationElement::ControlTypeProperty->Id, controlTypes);
   }

data/ext/UiaDll/UiaDll/ExpandCollapseMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) ExpandCollapseInfoPtr ExpandCollapse_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      auto info = Find(element)->As<ExpandCollapsePattern^>(ExpandCollapsePattern::Pattern)->Current;
+      auto info = ElementFrom(element)->As<ExpandCollapsePattern^>(ExpandCollapsePattern::Pattern)->Current;
       return new ExpandCollapseInfo(info.ExpandCollapseState.ToString());
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
@@ -17,7 +17,7 @@ extern "C" {
 
   __declspec(dllexport) void ExpandCollapse_Expand(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<ExpandCollapsePattern^>(ExpandCollapsePattern::Pattern)->Expand();
+      ElementFrom(element)->As<ExpandCollapsePattern^>(ExpandCollapsePattern::Pattern)->Expand();
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
@@ -25,7 +25,7 @@ extern "C" {
 
   __declspec(dllexport) void ExpandCollapse_Collapse(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<ExpandCollapsePattern^>(ExpandCollapsePattern::Pattern)->Collapse();
+      ElementFrom(element)->As<ExpandCollapsePattern^>(ExpandCollapsePattern::Pattern)->Collapse();
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }

data/ext/UiaDll/UiaDll/InvokePatternMethods.cpp

@@ -3,7 +3,7 @@
 extern "C" {
   __declspec(dllexport) void Invoke(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<InvokePattern^>(InvokePattern::Pattern)->Invoke();
+      ElementFrom(element)->As<InvokePattern^>(InvokePattern::Pattern)->Invoke();
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }

data/ext/UiaDll/UiaDll/RangeValueMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) RangeValueInformationPtr RangeValue_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      return new RangeValueInformation(Find(element)->As<RangeValuePattern^>(RangeValuePattern::Pattern)->Current);
+      return new RangeValueInformation(ElementFrom(element)->As<RangeValuePattern^>(RangeValuePattern::Pattern)->Current);
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
       return NULL;
@@ -16,7 +16,7 @@ extern "C" {
 
   __declspec(dllexport) void RangeValue_SetValue(ElementInformationPtr element, double value, char* errorInfo, const int errorInfoLength) {
     try {
-      return Find(element)->As<RangeValuePattern^>(RangeValuePattern::Pattern)->SetValue(value);
+      return ElementFrom(element)->As<RangeValuePattern^>(RangeValuePattern::Pattern)->SetValue(value);
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }

data/ext/UiaDll/UiaDll/SelectionItemMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) SelectionItemInformationPtr SelectionItem_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      auto info = Find(element)->As<SelectionItemPattern^>(SelectionItemPattern::Pattern)->Current;
+      auto info = ElementFrom(element)->As<SelectionItemPattern^>(SelectionItemPattern::Pattern)->Current;
       return new SelectionItemInformation(info);
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
@@ -17,7 +17,7 @@ extern "C" {
 
   __declspec(dllexport) void SelectionItem_Select(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<SelectionItemPattern^>(SelectionItemPattern::Pattern)->Select();
+      ElementFrom(element)->As<SelectionItemPattern^>(SelectionItemPattern::Pattern)->Select();
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
@@ -25,7 +25,7 @@ extern "C" {
 
   __declspec(dllexport) void SelectionItem_AddToSelection(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<SelectionItemPattern^>(SelectionItemPattern::Pattern)->AddToSelection();
+      ElementFrom(element)->As<SelectionItemPattern^>(SelectionItemPattern::Pattern)->AddToSelection();
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
@@ -33,7 +33,7 @@ extern "C" {
 
   __declspec(dllexport) void SelectionItem_RemoveFromSelection(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<SelectionItemPattern^>(SelectionItemPattern::Pattern)->RemoveFromSelection();
+      ElementFrom(element)->As<SelectionItemPattern^>(SelectionItemPattern::Pattern)->RemoveFromSelection();
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }

data/ext/UiaDll/UiaDll/SelectionMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) SelectionInformationPtr Selection_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      return new SelectionInformation(Find(element)->As<SelectionPattern^>(SelectionPattern::Pattern)->Current);
+      return new SelectionInformation(ElementFrom(element)->As<SelectionPattern^>(SelectionPattern::Pattern)->Current);
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
       return NULL;
@@ -16,7 +16,7 @@ extern "C" {
 
   __declspec(dllexport) int Selection_Selections(ElementInformationPtr element, ElementInformation** selections, char* errorInfo, const int errorInfoLength) {
     try {
-      auto selectedElements = Element::From(Find(element)->As<SelectionPattern^>(SelectionPattern::Pattern)->Current.GetSelection());
+      auto selectedElements = Element::From(ElementFrom(element)->As<SelectionPattern^>(SelectionPattern::Pattern)->Current.GetSelection());
       *selections = ElementInformation::From(selectedElements);
       return selectedElements->Length;
     } catch(Exception^ e) {

data/ext/UiaDll/UiaDll/Stdafx.h

@@ -15,4 +15,4 @@ using namespace UIA::Helper;
 #include "PatternInformationStructures.h"
 #include <list>
 
-extern "C" Element^ Find(ElementInformationPtr element);
+extern "C" Element^ ElementFrom(ElementInformationPtr element);

data/ext/UiaDll/UiaDll/TableItemMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) TableItemInformationPtr TableItem_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      return new TableItemInformation(Find(element)->As<TableItemPattern^>(TableItemPattern::Pattern)->Current);
+      return new TableItemInformation(ElementFrom(element)->As<TableItemPattern^>(TableItemPattern::Pattern)->Current);
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
       return NULL;

data/ext/UiaDll/UiaDll/TableMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) TableInformationPtr Table_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      return new TableInformation(Find(element)->As<TablePattern^>(TablePattern::Pattern)->Current);
+      return new TableInformation(ElementFrom(element)->As<TablePattern^>(TablePattern::Pattern)->Current);
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
       return NULL;
@@ -16,7 +16,7 @@ extern "C" {
 
   __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();
+      auto headerElements = ElementFrom(element)->As<TablePattern^>(TablePattern::Pattern)->Current.GetColumnHeaders();
       *headers = ElementInformation::From(Element::From(headerElements));
       return headerElements->Length;
     } catch(Exception^ e) {

data/ext/UiaDll/UiaDll/TextMethods.cpp

@@ -3,7 +3,7 @@
 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);
+      auto theText = ElementFrom(element)->As<TextPattern^>(TextPattern::Pattern)->DocumentRange->GetText(-1);
       if( NULL != text ) {
         StringHelper::CopyToUnmanagedString(theText, text, textLength);
       }

data/ext/UiaDll/UiaDll/ToggleMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) ToggleInformationPtr Toggle_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      auto info = Find(element)->As<TogglePattern^>(TogglePattern::Pattern)->Current;
+      auto info = ElementFrom(element)->As<TogglePattern^>(TogglePattern::Pattern)->Current;
       return new ToggleInformation(info.ToggleState.ToString());
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
@@ -17,7 +17,7 @@ extern "C" {
 
   __declspec(dllexport) void Toggle(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<TogglePattern^>(TogglePattern::Pattern)->Toggle();
+      ElementFrom(element)->As<TogglePattern^>(TogglePattern::Pattern)->Toggle();
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }

data/ext/UiaDll/UiaDll/ValuePatternMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) void Value_Set(ElementInformationPtr element, const char* value, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<ValuePattern^>(ValuePattern::Pattern)->SetValue(gcnew String(value));
+      ElementFrom(element)->As<ValuePattern^>(ValuePattern::Pattern)->SetValue(gcnew String(value));
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
@@ -15,7 +15,7 @@ extern "C" {
 
   __declspec(dllexport) ValuePatternInformationPtr Value_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      auto valuePattern = Find(element)->As<ValuePattern^>(ValuePattern::Pattern);
+      auto valuePattern = ElementFrom(element)->As<ValuePattern^>(ValuePattern::Pattern);
       return new ValuePatternInformation(valuePattern->Current);
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);

data/ext/UiaDll/UiaDll/WindowMethods.cpp

@@ -7,7 +7,7 @@ extern "C" {
 
   __declspec(dllexport) WindowInformationPtr Window_Information(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      return new WindowInformation(Find(element)->As<WindowPattern^>(WindowPattern::Pattern)->Current);
+      return new WindowInformation(ElementFrom(element)->As<WindowPattern^>(WindowPattern::Pattern)->Current);
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
       return NULL;
@@ -16,7 +16,7 @@ extern "C" {
 
   __declspec(dllexport) void Window_SetVisualState(ElementInformationPtr element, const char* visualState, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<WindowPattern^>(WindowPattern::Pattern)->SetWindowVisualState((WindowVisualState) Enum::Parse(WindowVisualState::typeid, gcnew String(visualState), false));
+      ElementFrom(element)->As<WindowPattern^>(WindowPattern::Pattern)->SetWindowVisualState((WindowVisualState) Enum::Parse(WindowVisualState::typeid, gcnew String(visualState), false));
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }
@@ -24,7 +24,7 @@ extern "C" {
 
   __declspec(dllexport) void Window_Close(ElementInformationPtr element, char* errorInfo, const int errorInfoLength) {
     try {
-      Find(element)->As<WindowPattern^>(WindowPattern::Pattern)->Close();
+      ElementFrom(element)->As<WindowPattern^>(WindowPattern::Pattern)->Close();
     } catch(Exception^ e) {
       StringHelper::CopyToUnmanagedString(e->Message, errorInfo, errorInfoLength);
     }

data/lib/uia/element.rb

@@ -57,6 +57,10 @@ module Uia
       find_child(@element, locator)
     end
 
+    def find_all(locator)
+      find_children(@element, locator)
+    end
+
     def locators_match?(locator)
       locator.all? do |locator, value|
         case locator

data/lib/uia/finder.rb

@@ -31,7 +31,7 @@ module Uia
     def find_child(parent, locator)
       scope = (locator.delete(:scope) || :descendants).to_s.capitalize
 
-      valid_locators = [:title, :handle, :id, :name, :value, :control_type, :scope]
+      valid_locators = [:title, :handle, :id, :name, :value, :control_type, :pattern, :scope]
       raise BadChildLocator, locator unless (locator.keys - valid_locators).empty?
 
       case
@@ -41,10 +41,20 @@ module Uia
           find_by_handle locator[:handle]
         else
           conditions = locator.collect {|k, v|  Library.send("#{k}_condition", v) }
-          Library.find_by_conditions parent, scope, *conditions
+          Library.find_first parent, scope, *conditions
       end
     end
 
+    def find_children(parent, locator)
+      scope = (locator.delete(:scope) || :descendants).to_s.capitalize
+
+      valid_locators = [:id, :name, :value, :control_type, :pattern, :scope]
+      raise BadChildLocator, locator unless (locator.keys - valid_locators).empty?
+
+      conditions = locator.collect {|k, v|  Library.send("#{k}_condition", v) }
+      Library.find_all parent, scope, *conditions
+    end
+
     private
     def find_by_id(id)
       find_by_property(:id, id)

data/lib/uia/library.rb

@@ -63,15 +63,21 @@ module Uia
     attach_throwable_function :find_by_pid, :Element_FindByProcessId, [:int], ManagedElementStruct.by_ref, &element_or_nil
     attach_throwable_function :find_by_handle, :Element_FindByHandle, [:int], ManagedElementStruct.by_ref, &element_or_nil
     attach_function :Element_FindByRuntimeId, [:pointer, :int, :pointer, :int], ManagedElementStruct.by_ref
-    attach_function :FindByConditions, [:pointer, :string, :pointer, :int, :int, :varargs], ManagedElementStruct.by_ref
+    attach_function :FindFirst, [:pointer, :string, :pointer, :int, :int, :varargs], ManagedElementStruct.by_ref
+    attach_function :FindAll, [:pointer, :pointer, :string, :pointer, :int, :int, :varargs], :int
 
     ## conditions
     attach_function :release_condition, :Condition_Release, [:pointer], :void
     attach_function :id_condition, :Condition_Id, [:string], SearchCondition.by_ref
+    attach_function :Condition_Pattern, [:string, :pointer, :int], SearchCondition.by_ref
     attach_function :name_condition, :Condition_Name, [:string], SearchCondition.by_ref
     self.singleton_class.send(:alias_method, :value_condition, :name_condition)
     attach_function :Condition_ControlType, [:int, :varargs], SearchCondition.by_ref
 
+    def self.pattern_condition(pattern)
+      can_throw(:Condition_Pattern, "Is#{pattern.to_camelized_s.delete(' ')}PatternAvailableProperty")
+    end
+
     def self.control_type_condition(*control_types)
       args = control_types.flatten.map(&:to_control_type_const).reduce([]) { |a, n| a << :int << n }
       Condition_ControlType control_types.count, *args
@@ -156,15 +162,28 @@ module Uia
       result
     end
 
-    def self.find_by_conditions(element, scope, *args)
+    def self.find_first(element, scope, *args)
       string_buffer = FFI::MemoryPointer.new :char, 1024
       conditions = args.reduce([]) { |a, c| a << :pointer << c }
-      result = FindByConditions element, scope, string_buffer, 1024, args.count, *conditions
+      result = FindFirst element, scope, string_buffer, 1024, args.count, *conditions
       error_info = string_buffer.read_string
       raise error_info unless error_info.empty?
       Uia::Element.new(result) unless result.empty?
     end
 
+    def self.find_all(element, scope, *args)
+      elements_pointer = FFI::MemoryPointer.new :pointer
+      string_buffer = FFI::MemoryPointer.new :char, 1024
+      conditions = args.reduce([]) { |a, c| a << :pointer << c }
+      result = FindAll element, elements_pointer, scope, string_buffer, 1024, args.count, *conditions
+      error_info = string_buffer.read_string
+      raise error_info unless error_info.empty?
+      result.times.collect do |which_element|
+        pointer = elements_pointer.read_pointer + which_element * ManagedElementStruct.size
+        Uia::Element.new(ManagedElementStruct.new(pointer))
+      end
+    end
+
   rescue LoadError => e
     raise LoadError, 'You must install the Visual Studio 2012 C++ Runtime Environment to use the Uia gem (http://www.microsoft.com/en-us/download/details.aspx?id=30679)'
   end

data/lib/uia/patterns/selection.rb

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

data/lib/uia/patterns/table.rb

@@ -3,7 +3,7 @@ module Uia
     module Table
       module Row
         def items
-          filter(pattern: :table_item).each { |e| e.as :table_item }
+          find_all(pattern: :table_item).each { |e| e.as :table_item }
         end
       end
 
@@ -20,7 +20,7 @@ module Uia
       end
 
       def rows
-        filter(control_type: :data_item).each { |e| e.extend Row }
+        find_all(control_type: :data_item).each { |e| e.extend Row }
       end
 
       private

data/lib/uia/version.rb

@@ -1,3 +1,3 @@
 module Uia
-  VERSION = '0.1.3.1'
+  VERSION = '0.2'
 end

data/spec/uia/element_spec.rb

@@ -122,10 +122,15 @@ describe Uia::Element do
       Then { element.find(control_type: [:custom, :semantic_zoom]).id == 'automatableMonthCalendar1' }
     end
 
+    context 'pattern' do
+      Then { element.find(pattern: :range_value).id == 'numericUpDown1' }
+    end
+
     context 'combinations' do
       Then { element.find(control_type: :list, name: 'linkLabel1').id == 'FruitListBox' }
       Then { element.find(control_type: :button, name: 'Forward', scope: :children) == nil }
-      Then { element.find(control_type: :custom, id: 'automatableMonthCalendar1').name == 'linkLabel1'}
+      Then { element.find(pattern: :invoke, name: 'About').id == 'aboutButton' }
+      Then { element.find(control_type: :custom, id: 'automatableMonthCalendar1').name == 'linkLabel1' }
       Then { element.find(value: 'linkLabel1', id: 'automatableMonthCalendar1').control_type == :custom }
     end
 
@@ -139,6 +144,14 @@ describe Uia::Element do
     end
   end
 
+  context '#find_all' do
+    Given(:list_box) { element.find(id: 'FruitListBox') }
+
+    Then { list_box.find_all(control_type: :list_item).map(&:name) == ['Apple', 'Orange', 'Mango'] }
+    Then { element.find_all(control_type: :tree_item, name: 'Parent Two').count == 1 }
+    Then { expect { element.find_all(handle: 123) }.to raise_error BadLocator }
+  end
+
   context '#filter' do
     context 'control_type' do
       When(:buttons) { element.filter(control_type: :radio_button) }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: uia
 version: !ruby/object:Gem::Version
-  version: 0.1.3.1
+  version: '0.2'
   prerelease: 
 platform: ruby
 authors:
@@ -255,7 +255,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -143354925
+      hash: 148459631
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -264,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -143354925
+      hash: 148459631
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.28