uia 0.4 → 0.4.1

data/ChangeLog

@@ -1,3 +1,7 @@
+=== Version 0.4.1 / 2014-05-14
+*   Enhancements
+    *   Element#help_text
+
 === Version 0.4 / 2014-05-13
 *   Enhancements
     *   MenuItems#menu_item - find by path

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

@@ -62,6 +62,11 @@ namespace UIA.Helper
             get { return _element.Current.Name; }
         }
 
+        public virtual string HelpText
+        {
+            get { return _element.Current.HelpText; }
+        }
+
         public virtual string ClassName
         {
             get { return _element.Current.ClassName; }

data/ext/UiaDll/UiaDll/ElementStructures.h

@@ -7,6 +7,7 @@ typedef struct _ElementInformation {
   int* runtimeId;
   int runtimeIdLength;
   char* name;
+  char* helpText;
   char* className;
   int controlTypeId;
   int* patterns;
@@ -18,9 +19,9 @@ typedef struct _ElementInformation {
   bool hasKeyboardFocus;
   long boundingRectangle[4];
 
-  _ElementInformation() : name(NULL), nativeWindowHandle(0), runtimeId(NULL), patterns(NULL), id(NULL), className(NULL) {}
+  _ElementInformation() : name(NULL), nativeWindowHandle(0), runtimeId(NULL), patterns(NULL), id(NULL), className(NULL), helpText(NULL) {}
 
-  _ElementInformation(Element^ element) : name(NULL), nativeWindowHandle(0), runtimeId(NULL), patterns(NULL), id(NULL), className(NULL) {
+  _ElementInformation(Element^ element) : name(NULL), nativeWindowHandle(0), runtimeId(NULL), patterns(NULL), id(NULL), className(NULL), helpText(NULL) {
     Refresh(element);
   }
 
@@ -56,6 +57,8 @@ typedef struct _ElementInformation {
     isVisible = element->IsVisible;
     hasKeyboardFocus = element->HasKeyboardFocus;
 
+    helpText = StringHelper::ToUnmanaged(element->HelpText);
+
     auto r = element->BoundingRectangle;
     for(auto coord = 0; coord < 4; coord++) {
       boundingRectangle[coord] = r[coord];
@@ -68,8 +71,8 @@ typedef struct _ElementInformation {
 
 private:
   void Reset() {
-    delete[] name; delete[] runtimeId; delete[] patterns; delete[] id; delete[] className;
-    name = NULL; runtimeId = NULL; patterns = NULL; id = NULL; className = NULL;
+    delete[] name; delete[] runtimeId; delete[] patterns; delete[] id; delete[] className; delete[] helpText;
+    name = NULL; runtimeId = NULL; patterns = NULL; id = NULL; className = NULL; helpText = NULL;
   }
 
 } ElementInformation, *ElementInformationPtr;

data/ext/UiaDll/UiaDll.Test/ElementInformationTest.cpp

@@ -37,6 +37,13 @@ TEST_F(ElementInformationTest, ItHasTheName)
   ASSERT_STREQ("Expected Name", ElementInformation(gcnew ElementStub("Expected Name")).name);
 }
 
+TEST_F(ElementInformationTest, ItHasTheHelpText) {
+  auto element = gcnew ElementStub("");
+  element->HelpText = gcnew String("Expected help text");
+
+  ASSERT_STREQ("Expected help text", ElementInformation(element).helpText);
+}
+
 TEST_F(ElementInformationTest, ItKnowsAboutTheRuntimeId)
 {
   auto elementInformation = ElementInformation(gcnew ElementStub("", 0, 1, 2));

data/ext/UiaDll/UiaDll.Test/ElementStub.h

@@ -16,6 +16,12 @@ public:
     void set(String^ name) { _name = name; }
   }
 
+  virtual property String^ HelpText
+  {
+    String^ get() override { return _helpText; }
+    void set(String^ helpText) { _helpText = helpText; }
+  }
+
   virtual property String^ ClassName
   {
     String^ get() override { return _className; }
@@ -80,6 +86,7 @@ public:
 
 private:
   String^ _name;
+  String^ _helpText;
   String^ _className;
   String^ _id;
   array<int>^ _runtimeIds;

data/lib/uia/element.rb

@@ -18,7 +18,7 @@ module Uia
       @default = lambda { [:unknown] }
     end
 
-    element_attr :id, :name, :handle, :runtime_id,
+    element_attr :id, :name, :handle, :runtime_id, :help_text,
                  :class_name, :children, :descendants
     refreshed_element_attr :enabled?, :visible?, :focused?, :bounding_rectangle
 

data/lib/uia/library/element_structs.rb

@@ -13,6 +13,7 @@ module Uia
                  :runtime_id, :pointer,
                  :number_of_ids, :int,
                  :name, :string,
+                 :help_text, :string,
                  :class_name, :string,
                  :control_type_id, :int,
                  :patterns, :pointer,
@@ -23,7 +24,7 @@ module Uia
                  :has_focus, :bool,
                  :bounding_rectangle, [:long, 4]
 
-          struct_attr :id, :name, :handle, :control_type_id, :class_name,
+          struct_attr :id, :name, :handle, :control_type_id, :class_name, :help_text,
                       [:enabled?, :is_enabled], [:visible?, :is_visible], [:focused?, :has_focus]
 
           def runtime_id

data/lib/uia/version.rb

@@ -1,3 +1,3 @@
 module Uia
-  VERSION = '0.4'
+  VERSION = '0.4.1'
 end

data/spec/uia/element_spec.rb

@@ -26,9 +26,12 @@ describe Uia::Element do
 
   context 'properties' do
     let(:raw_element) { element.instance_variable_get(:@element) }
+    Given(:about_button) { element.find name: 'About', control_type: :button }
+
     Then { element.handle != 0 }
     Then { element.name == 'MainFormWindow' }
     Then { element.id == 'MainFormWindow' }
+    Then { about_button.help_text =~ /click about to find out/i }
     Then { element.class_name =~ /Forms.*app/i }
     Then { expect(element.find(id: 'textField')).to be_enabled }
     Then do

data/test.rb

@@ -0,0 +1,5 @@
+require 'uia'
+
+def w
+  @w ||= Uia.find_element title: /^MainForm/
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: uia
 version: !ruby/object:Gem::Version
-  version: '0.4'
+  version: 0.4.1
   prerelease: 
 platform: ruby
 authors:
@@ -243,6 +243,7 @@ files:
 - spec/uia/patterns/value_spec.rb
 - spec/uia/patterns/window_spec.rb
 - spec/uia_spec.rb
+- test.rb
 - uia.gemspec
 - ext/UiaDll/Release/UiaDll.dll
 - ext/UiaDll/Release/UIA.Helper.dll
@@ -261,7 +262,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -662745805
+      hash: -1027979665
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -270,7 +271,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -662745805
+      hash: -1027979665
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.28