testability-driver-qt-sut-plugin 0.9.2 → 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (27) hide show
  1. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/application.rb +11 -8
  2. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/configure_behaviour.rb +3 -3
  3. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/events.rb +76 -74
  4. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/find.rb +2 -0
  5. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/fixture.rb +10 -4
  6. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/gesture.rb +49 -42
  7. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/infologger.rb +0 -9
  8. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/locale_db.rb +5 -0
  9. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/record.rb +11 -1
  10. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/sut.rb +441 -324
  11. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/synchronization.rb +32 -11
  12. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/treewidgetitemcolumn.rb +54 -34
  13. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/view_item.rb +26 -26
  14. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/webkit.rb +61 -21
  15. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb +528 -344
  16. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/controllers/application.rb +16 -138
  17. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/controllers/find_object.rb +3 -67
  18. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/controllers/fixture.rb +4 -18
  19. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/plugin.rb +1 -1
  20. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/sut/adapter.rb +166 -149
  21. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/sut/communication.rb +80 -75
  22. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/util/find_object_generator.rb +93 -0
  23. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/util/message_composer.rb +161 -0
  24. data/xml/behaviour/qt.xml +26 -26
  25. data/xml/template/qt.xml +9 -7
  26. metadata +7 -6
  27. data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/commands/fixture.rb +0 -45
data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/synchronization.rb CHANGED
@@ -50,18 +50,39 @@ module MobyBehaviour
50
50
 
51
51
  end
52
52
 
53
- # Execution of the test script is stopped and TDriver waits for the given signal. If no signals of the
54
- # given type are found before the timeout an error is raised.
53
+ # == description
54
+ # Synchronizes script execution to a signal. Test script execution is stopped until the expected signal is emitted or the timeout occurs.
55
+ # If no signals of the given type are found before the timeout an error is raised.\n
56
+ # \n
57
+ # [b]NOTE:[/b] Using wait_for_signal will reset and clear any previously set signal listening status.
58
+ # == arguments
59
+ # signal_timeout
60
+ # Fixnum
61
+ # description: Timeout, in seconds. A timeout of zero means that the signal must have been listened to and emitted before this method is called.
62
+ # example: 60
63
+ #
64
+ # signal_name
65
+ # String
66
+ # description: Name of the signal that is to be emitted.
67
+ # example: "clicked()"
68
+ #
69
+ # &block
70
+ # Proc
71
+ # description: Optional code block to be executed while listening signals
72
+ # example: -
73
+ #
74
+ # == returns
75
+ # NilClass
76
+ # description: -
77
+ # example: -
78
+ #
79
+ # == exceptions
80
+ # SignalNotEmittedException
81
+ # description: The expected signal was not emitted before the timeout was reached.
82
+ #
83
+ # ArgumentError
84
+ # description: signal_name was not a valid String or signal_timeout was not a non negative Integer
55
85
  #
56
- # === params
57
- # signal_timeout:: Integer, time to wait for signal, in seconds
58
- # signal_name:: String, name of the signal to wait for. Note that most signals end with ()
59
- # block:: (optional) code block to be executed while listening signals
60
- # === returns
61
- # nil
62
- # === errors
63
- # SignalNotEmittedException:: The given signal was n ot received before the timeout
64
- # ArgumentError:: signal_timeout was not a positive Integer or signal_name was not a nonempty String
65
86
  def wait_for_signal( signal_timeout, signal_name, &block )
66
87
 
67
88
  Kernel::raise ArgumentError.new("The timeout argument was of wrong type: expected 'Integer' was '%s'" % signal_timeout.class ) unless signal_timeout.kind_of?( Integer )
data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/treewidgetitemcolumn.rb CHANGED
@@ -48,40 +48,60 @@ module MobyBehaviour
48
48
 
49
49
  include MobyBehaviour::QT::Behaviour
50
50
 
51
- # Sets the check state of the item in a treewidget
52
- # == params
53
- # == returns
54
- # == raises
55
- def check_state(new_state)
56
-
57
- ret = nil
58
-
59
- begin
60
-
61
- raise ArgumentError.new( "new_state must be an integer. Check qt docs for allowed values (Qt::CheckState." ) unless new_state.kind_of?(Integer)
62
-
63
- command = MobyCommand::WidgetCommand.new
64
- command.object_id(self.attribute('parentWidget'))
65
- command.application_id(get_application_id)
66
- command.object_type(:Standard)
67
- command.command_name('CheckState')
68
- command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
69
- params = {:state => new_state, :column => self.attribute('column'), :item => self.attribute('parentItem')}
70
-
71
- command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
72
-
73
- command.command_params(params)
74
- @sut.execute_command(command)
75
-
76
- rescue Exception => e
77
-
78
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed select"#{identity};drag;"
79
- Kernel::raise e
80
-
81
- end
82
-
83
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation select executed successfully"#{identity};drag;"
84
- ret
51
+ # == description
52
+ # Sets the check state of the item in QTreeWidgetItemColumn.\n
53
+ #
54
+ # == arguments
55
+ # new_state
56
+ # Integer
57
+ # description: State of checkable item, see supported values in [link="#check_state_enums"]table[/link] below
58
+ # example: 0
59
+ #
60
+ # == returns
61
+ # NilClass
62
+ # description: -
63
+ # example: -
64
+ #
65
+ # == tables
66
+ # check_state_enums
67
+ # title: Supported item states (Qt 4.7)
68
+ # description: See Qt documentation for allowed values to QT::CheckState
69
+ # |Enum|Value|Description|
70
+ # |Qt::Unchecked|0|The item is unchecked.|
71
+ # |Qt::PartiallyChecked|1|The item is partially checked.|
72
+ # |Qt::Checked|2|The item is checked.|
73
+ #
74
+ # == returns
75
+ def check_state( new_state )
76
+
77
+ ret = nil
78
+
79
+ begin
80
+
81
+ raise ArgumentError.new( "new_state must be an integer. Check qt docs for allowed values (Qt::CheckState." ) unless new_state.kind_of?(Integer)
82
+
83
+ command = MobyCommand::WidgetCommand.new
84
+ command.object_id(self.attribute('parentWidget'))
85
+ command.application_id(get_application_id)
86
+ command.object_type(:Standard)
87
+ command.command_name('CheckState')
88
+ command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
89
+ params = {:state => new_state, :column => self.attribute('column'), :item => self.attribute('parentItem')}
90
+
91
+ command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
92
+
93
+ command.command_params(params)
94
+ @sut.execute_command(command)
95
+
96
+ rescue Exception => e
97
+
98
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed select"#{identity};drag;"
99
+ Kernel::raise e
100
+
101
+ end
102
+
103
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation select executed successfully"#{identity};drag;"
104
+ ret
85
105
 
86
106
  end
87
107
 
data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/view_item.rb CHANGED
@@ -17,8 +17,6 @@
17
17
  ##
18
18
  ############################################################################
19
19
 
20
-
21
-
22
20
  module MobyBehaviour
23
21
 
24
22
  module QT
@@ -48,43 +46,45 @@ module MobyBehaviour
48
46
 
49
47
  include MobyBehaviour::QT::Behaviour
50
48
 
49
+ # == description
51
50
  # Selects an item from a list that uses qt view model system (e.g. QTreeView)
52
- # == params
53
- # == returns
54
- # == raises
51
+ # == returns
52
+ # NilClass
53
+ # description: -
54
+ # example: -
55
55
  def select
56
56
 
57
- ret = nil
57
+ ret = nil
58
58
 
59
- begin
59
+ begin
60
60
 
61
- button=:Left
62
- command = MobyCommand::WidgetCommand.new
63
- command.object_id(self.attribute('viewPort'))
64
- command.application_id(get_application_id)
65
- command.object_type(:Standard)
66
- command.command_name('Tap')
67
- command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
61
+ button = :Left
62
+ command = MobyCommand::WidgetCommand.new
63
+ command.object_id(self.attribute('viewPort'))
64
+ command.application_id(get_application_id)
65
+ command.object_type(:Standard)
66
+ command.command_name('Tap')
67
+ command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
68
68
 
69
- mouse_move = @sut.parameter[:in_tap_move_pointer]
70
- mouse_move = 'false' unless mouse_move
69
+ mouse_move = @sut.parameter[:in_tap_move_pointer]
70
+ mouse_move = 'false' unless mouse_move
71
71
 
72
- params = {'x'=>center_x, 'y' => center_y, 'count' => 1, 'button' => @@_buttons_map[button], 'mouseMove'=>mouse_move, 'useCoordinates' => 'true'}
72
+ params = {'x'=>center_x, 'y' => center_y, 'count' => 1, 'button' => @@_buttons_map[button], 'mouseMove'=>mouse_move, 'useCoordinates' => 'true'}
73
73
 
74
- command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
74
+ command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
75
75
 
76
- command.command_params(params)
77
- @sut.execute_command(command)
76
+ command.command_params(params)
77
+ @sut.execute_command(command)
78
78
 
79
- rescue Exception => e
79
+ rescue Exception => e
80
80
 
81
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed select"#{identity};drag;"
82
- Kernel::raise e
81
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed select"#{identity};drag;"
82
+ Kernel::raise e
83
83
 
84
- end
84
+ end
85
85
 
86
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation select executed successfully"#{identity};drag;"
87
- ret
86
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation select executed successfully"#{identity};drag;"
87
+ ret
88
88
 
89
89
  end
90
90
 
data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/webkit.rb CHANGED
@@ -46,6 +46,8 @@ module MobyBehaviour
46
46
 
47
47
  include MobyBehaviour::QT::Behaviour
48
48
 
49
+ # == nodoc
50
+ # == description
49
51
  # Send javascript to target object on the screen
50
52
  # == params
51
53
  # java_script::( )java script to be executed to target object
@@ -104,19 +106,34 @@ module MobyBehaviour
104
106
  returnValue
105
107
 
106
108
  end
107
-
108
-
109
-
110
- # Send javascript to target object on the screen
111
- # == params
112
- # java_script::( )java script to be executed to target object
113
- # == returns
109
+
110
+ # == description
111
+ # Executes java script on the target test object
112
+ #
113
+ # == arguments
114
+ # java_script
115
+ # String
116
+ # description: Script to be executed to target object
117
+ # example: "this.onclick();"
118
+ #
119
+ # == returns
120
+ # MobyBase::TestObject
121
+ # description: Target test object
122
+ # example: -
123
+ #
114
124
  # == raises
115
- # TestObjectNotFoundError:: If a graphics item is not visible on screen
116
- # ArgumentError:: If an invalid button type is given
117
- # ArgumentError:: If coordinates are outside of the object
118
- # === examples
119
- # @object.execute_javascript
125
+ # RuntimeError
126
+ # description: When executing JavaScript to QWebFrame: QWebPage not found.
127
+ #
128
+ # RuntimeError
129
+ # description: When executing JavaScript to QWebFrame: QWebFrame not found.
130
+ #
131
+ # RuntimeError
132
+ # description: When executing JavaScript to WebElement: QWebPage not found.
133
+ #
134
+ # RuntimeError
135
+ # description: When executing JavaScript to WebElement: QWebElement not found.
136
+ #
120
137
  def execute_javascript( java_script )
121
138
 
122
139
  webframe_id = 0
@@ -143,15 +160,38 @@ module MobyBehaviour
143
160
  execute_javascript_query( java_script, nil, index, webframe_id)
144
161
  end
145
162
 
146
- # Scrolls the
147
- # == params
148
- # dx, dy. pixels to scroll down (value may be negative)
149
- # == returns
150
- # == raises
163
+ # == description
164
+ # Scroll QWebFrame to correct position. Valid target object types are: QWebFrame, all QWebElements.
165
+ #
166
+ # == arguments
167
+ # dx
168
+ # Fixnum
169
+ # description: Delta x in pixels, positive value to right negative to left. Ignored for QWebElements.
170
+ # example: 313
171
+ #
172
+ # dy
173
+ # Fixnum
174
+ # description: Delta y in pixels, positive value to down negative to up. Ignored for QWebElements.
175
+ # example: 313
176
+ #
177
+ # center
178
+ # Fixnum
179
+ # description: Value 1 means that scroll is done only to reveal the center position of the element. Value 0 means that element is tried to bring fully visible. Ignored for QWebFrame.
180
+ # example: 1
181
+ #
182
+ # == returns
183
+ # NilClass
184
+ # description: -
185
+ # example: -
186
+ #
187
+ # == exceptions
188
+ # RuntimeError
189
+ # description: Scrollign webframe failed with error: %s
190
+ #
151
191
  # === examples
152
192
  # @QwebFrame.scroll(0, 10)
153
193
  # @app.a.scroll()
154
- def scroll( dx=0, dy=0, tap=0 )
194
+ def scroll( dx = 0, dy = 0, center = 0 )
155
195
  temp_id = ""
156
196
 
157
197
  if type == "QWebFrame"
@@ -171,7 +211,7 @@ module MobyBehaviour
171
211
  frame_down_border = y_absolute + height - horizontalScrollBarHeight
172
212
  frame_right_border = x_absolute + width - verticalScrollBarWidth
173
213
 
174
- if(tap==1)
214
+ if(center==1)
175
215
 
176
216
  #adjust image to be visible for tap
177
217
  if(center_y.to_i > frame_down_border)
@@ -219,8 +259,8 @@ module MobyBehaviour
219
259
  end
220
260
 
221
261
 
222
- # enable hooking for performance measurement & debug logging
223
- MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
262
+ # enable hooking for performance measurement & debug logging
263
+ MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
224
264
 
225
265
 
226
266
  end # Webkit
data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb CHANGED
@@ -1,28 +1,28 @@
1
1
  ############################################################################
2
- ##
3
- ## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
4
- ## All rights reserved.
5
- ## Contact: Nokia Corporation (testabilitydriver@nokia.com)
6
- ##
7
- ## This file is part of TDriver.
8
- ##
9
- ## If you have questions regarding the use of this file, please contact
10
- ## Nokia at testabilitydriver@nokia.com .
11
- ##
12
- ## This library is free software; you can redistribute it and/or
13
- ## modify it under the terms of the GNU Lesser General Public
14
- ## License version 2.1 as published by the Free Software Foundation
15
- ## and appearing in the file LICENSE.LGPL included in the packaging
16
- ## of this file.
17
- ##
2
+ ##
3
+ ## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
4
+ ## All rights reserved.
5
+ ## Contact: Nokia Corporation (testabilitydriver@nokia.com)
6
+ ##
7
+ ## This file is part of TDriver.
8
+ ##
9
+ ## If you have questions regarding the use of this file, please contact
10
+ ## Nokia at testabilitydriver@nokia.com .
11
+ ##
12
+ ## This library is free software; you can redistribute it and/or
13
+ ## modify it under the terms of the GNU Lesser General Public
14
+ ## License version 2.1 as published by the Free Software Foundation
15
+ ## and appearing in the file LICENSE.LGPL included in the packaging
16
+ ## of this file.
17
+ ##
18
18
  ############################################################################
19
19
 
20
20
 
21
21
 
22
- # TODO: document
22
+ # TODO: document
23
23
  module MobyBehaviour
24
24
 
25
- module QT
25
+ module QT
26
26
 
27
27
  # == description
28
28
  # Widget specific behaviours
@@ -45,20 +45,28 @@ module MobyBehaviour
45
45
  # == objects
46
46
  # *
47
47
  #
48
- module Widget
48
+ module Widget
49
49
 
50
- include MobyBehaviour::QT::Behaviour
50
+ include MobyBehaviour::QT::Behaviour
51
51
 
52
- # Moves the mouse to the object it was called on.
53
- # == params
54
- # refresh::(optional) if true will cause the framework to refresh the ui state. Default is false.
55
- # === examples
56
- # @object.move_mouse
57
- def move_mouse( move_params = false )
52
+ # == description
53
+ # Moves the mouse to the object it was called on.
54
+ # == arguments
55
+ # move_params
56
+ # Boolean
57
+ # description: if true will cause the framework to refresh the UI state
58
+ # example: true
59
+ # == returns
60
+ # NilClass
61
+ # description: -
62
+ # example: -
63
+ # == examples
64
+ # @object.move_mouse
65
+ def move_mouse( move_params = false )
58
66
 
59
67
  $stderr.puts "#{ caller(0).last.to_s } warning: move_mouse(boolean) is deprecated; use move_mouse(Hash)" if move_params == true
60
68
 
61
- begin
69
+ begin
62
70
  # Hide all future params in a hash
63
71
  use_tap_screen = false
64
72
  if move_params.kind_of? Hash
@@ -67,47 +75,82 @@ module MobyBehaviour
67
75
  else
68
76
  use_tap_screen = MobyUtil::Parameter[ @sut.id][ :use_tap_screen, 'false']
69
77
  end
70
- command = command_params #in qt_behaviour
71
- command.command_name('MouseMove')
78
+ command = command_params #in qt_behaviour
79
+ command.command_name('MouseMove')
72
80
 
73
81
  if attribute('objectType') == 'Web' or attribute('objectType') == 'Embedded'
74
- params = {'x' => center_x, 'y' => center_y, 'useCoordinates' => 'true',
75
- 'useTapScreen' => use_tap_screen}
76
- else
77
- params = {'useTapScreen' => use_tap_screen.to_s}
78
- end
82
+ params = {
83
+ 'x' => center_x,
84
+ 'y' => center_y,
85
+ 'useCoordinates' => 'true',
86
+ 'useTapScreen' => use_tap_screen,
87
+ 'x_off' => MobyUtil::Parameter[ @sut.id ][:tap_x_offset , '0' ],
88
+ 'y_off' => MobyUtil::Parameter[ @sut.id ][:tap_y_offset , '0' ]
89
+ }
90
+ else
91
+ params = {'useTapScreen' => use_tap_screen.to_s}
92
+ end
79
93
  command.command_params(params)
80
94
 
81
- @sut.execute_command(command)
82
-
83
- rescue Exception => e
84
-
85
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed to mouse_move"
86
- Kernel::raise e
87
- end
88
-
89
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation mouse_move executed successfully"
90
-
91
- nil
92
-
93
- end
94
-
95
- # Taps the screen on the coordinates of the object.
96
- # == params
97
- # tap_count::(optional defaults to 1)number of times to tap the screen
98
- # button::(optional defaults to :Left) button symbol supported values are: :NoButton, :Left, :Right, :Middle
99
- # x::(optional defaults to nil) x coordinate inside object to click, if nil then center is used
100
- # y::(optional defaults to nil) y coordinate inside object to click, if nil then center is used
101
- # == returns
102
- # == raises
103
- # TestObjectNotFoundError:: If a graphics item is not visible on screen
104
- # ArgumentError:: If an invalid button type is given
105
- # ArgumentError:: If coordinates are outside of the object
106
- # === examples
107
- # @object.tap
108
- # def tap( tap_count = 1, interval = nil, button = :Left)
109
- # def tap( tap_count = 1, interval = nil, button = :Left, tap_screen = false, duration = 0.1 )
110
- def tap( tap_params = 1, interval = nil, button = :Left )
95
+ @sut.execute_command(command)
96
+
97
+ rescue Exception => e
98
+
99
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed to mouse_move"
100
+ Kernel::raise e
101
+ end
102
+
103
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation mouse_move executed successfully"
104
+
105
+ nil
106
+
107
+ end
108
+
109
+ # == description
110
+ # Taps the screen on the coordinates of the object.
111
+ #
112
+ # == arguments
113
+ # tap_params
114
+ # Hash
115
+ # description: arguments hash, see table below. If integer instead of a Hash, then this has deprecated meaning tap_count, which is also why default value is a number.
116
+ # example: -
117
+ # interval
118
+ # Integer
119
+ # description: DEPRECATED, use hash key :interval instead
120
+ # example: -
121
+ # button
122
+ # Symbol
123
+ # description: DEPRECATED, use hash key :button instead
124
+ # example: -
125
+ #
126
+ # == tables
127
+ # tap_params_table
128
+ # title: Hash argument tap_params
129
+ # description: Valid keys for argument tap_params as hash
130
+ # |Key|Description|Type|Example|Default|
131
+ # |:button|Button to use for tapping|Symbol|:Right|:Left|
132
+ # |:duration|Duration in seconds for a single left button press, all other arguments ignored|Numeric|0.1|-|
133
+ # |:interval|This method sleeps tap_count times interval|Integer|2|1|
134
+ # |:tap_count|Number of taps to do|Integer|2|1|
135
+ # |:use_tap_screen|Should tapping be done on screen or as mouse event to the object|Boolean|true|see TDriver parameters table below|
136
+ # tdriver_params_table
137
+ # title: Default values read from tdriver parameters
138
+ # description: These setting values are read from tdriver_parameters.xml
139
+ # |Name|Description|Default if missing from parameters|
140
+ # |use_tap_screen|See :use_tap_screen above|false|
141
+ # |in_tap_move_pointer|Wether to actually move mouse pointer to tap coordinates|false|
142
+ #
143
+ # == returns
144
+ # NilClass
145
+ # description: -
146
+ # example: -
147
+ #
148
+ # == exceptions
149
+ # TestObjectNotFoundError
150
+ # description: object is not visible on screen
151
+ # ArgumentError
152
+ # description: Invalid button or non-integer interval
153
+ def tap( tap_params = 1, interval = nil, button = :Left )
111
154
  # tapMeasure = Time.now
112
155
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - tap start"
113
156
 
@@ -120,17 +163,17 @@ module MobyBehaviour
120
163
  return
121
164
  end
122
165
 
123
- begin
124
- #for api compatibility
125
- if interval and interval.kind_of?(Symbol)
126
- button = interval
166
+ begin
167
+ #for api compatibility
168
+ if interval and interval.kind_of?(Symbol)
169
+ button = interval
127
170
  interval = nil
128
- end
129
-
171
+ end
172
+
130
173
  # Another one, first param a has for the rest
131
174
  if tap_params.kind_of?(Hash)
132
175
  interval = tap_params[:interval]
133
- if tap_params[:button].nil?
176
+ if tap_params[:button].nil?
134
177
  button = :Left
135
178
  else
136
179
  button = tap_params[:button]
@@ -142,39 +185,43 @@ module MobyBehaviour
142
185
  else
143
186
  tap_count = tap_params
144
187
 
145
- use_tap_screen = MobyUtil::Parameter[@sut.id][ :use_tap_screen, 'false']
188
+ use_tap_screen = MobyUtil::Parameter[@sut.id][ :use_tap_screen, 'false']
146
189
  end
147
190
 
148
- raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
149
- if interval
191
+ raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
192
+ if interval
150
193
  raise ArgumentError.new( "Invalid interval must be an integer." ) unless interval.kind_of?(Integer)
151
194
  end
152
-
153
- command = command_params #in qt_behaviour
195
+
196
+ command = command_params #in qt_behaviour
154
197
  command.command_name('Tap')
155
-
198
+
156
199
  params = {
157
- 'count' => tap_count.to_s,
158
- 'button' => @@_buttons_map[button],
159
- 'mouseMove' => MobyUtil::Parameter[ @sut.id ][ :in_tap_move_pointer, 'false' ],
160
- 'useTapScreen' => use_tap_screen
161
- }
200
+ 'count' => tap_count.to_s,
201
+ 'button' => @@_buttons_map[button],
202
+ 'mouseMove' => MobyUtil::Parameter[ @sut.id ][ :in_tap_move_pointer, 'false' ],
203
+ 'useTapScreen' => use_tap_screen,
204
+ 'x_off' => MobyUtil::Parameter[ @sut.id ][:tap_x_offset , '0' ],
205
+ 'y_off' => MobyUtil::Parameter[ @sut.id ][:tap_y_offset , '0' ]
206
+ }
162
207
 
163
208
 
164
209
  if interval
165
- params[:interval] = (interval.to_f * 1000).to_i
210
+ params[:interval] = (interval.to_f * 1000).to_i
166
211
  end
167
212
 
168
213
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - before webs"
169
214
 
170
215
  if attribute('objectType') == 'Web' or attribute('objectType') == 'Embedded'
171
- params['x'] = center_x
172
- params['y'] = center_y
216
+ #params['obj_x'] = (center_x.to_i - 1).to_s
217
+ #params['obj_y'] = (center_y.to_i - 1).to_s
218
+ params['x'] = (center_x.to_i - 1).to_s
219
+ params['y'] = (center_y.to_i - 1).to_s
173
220
  params['useCoordinates'] = 'true'
174
- end
221
+ end
175
222
 
176
223
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - before 2 webs"
177
-
224
+
178
225
  if(attribute('objectType') == 'Web')
179
226
  if type != "QWebFrame"
180
227
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - Not q webframe"
@@ -183,14 +230,17 @@ module MobyBehaviour
183
230
  y_absolute = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='y_absolute']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
184
231
  width = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='width']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
185
232
  height = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='height']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
186
-
233
+
234
+ horizontalScrollBarHeight = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='horizontalScrollBarHeight']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
235
+ verticalScrollBarWidth = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='verticalScrollBarWidth']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
236
+
187
237
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - x_a(#{x_absolute}), y_a(#{y_absolute}), w(#{width}), h(#{height})"
188
-
238
+
189
239
 
190
240
  if((center_x.to_i < x_absolute) or
191
- (center_x.to_i > x_absolute + width) or
241
+ (center_x.to_i > x_absolute + width - verticalScrollBarWidth) or
192
242
  (center_y.to_i < y_absolute) or
193
- (center_y.to_i > y_absolute + height)
243
+ (center_y.to_i > y_absolute + height - horizontalScrollBarHeight)
194
244
  )
195
245
  #puts "web element scroll"
196
246
  self.scroll(0,0,1) # enable tap centralization
@@ -200,78 +250,80 @@ module MobyBehaviour
200
250
  return
201
251
  end
202
252
  end
203
- end
253
+ end
204
254
  command.command_params(params)
205
-
255
+
206
256
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - tap about to execute "
207
- @sut.execute_command( command )
257
+ @sut.execute_command( command )
208
258
 
209
259
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - executed"
210
260
  #do not allow operations to continue untill taps done
211
261
  if interval
212
262
  sleep interval * tap_count
213
263
  end
214
-
215
- rescue Exception => e
264
+
265
+ rescue Exception => e
216
266
 
217
267
  MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed tap with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};tap;"
218
- Kernel::raise e
268
+ Kernel::raise e
219
269
 
220
- end
270
+ end
221
271
 
222
272
  MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation tap executed successfully with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};tap;"
223
273
 
224
274
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - tapping ending"
225
275
 
226
-
276
+
227
277
  nil
228
278
 
229
279
  end
230
280
 
281
+
231
282
  # == description
232
- # Taps the screen on the specified coordinates of the object. Given coordinates are relative to the object.
283
+ # Taps the screen on the specified coordinates of the object. Given coordinates are relative to the object.
233
284
  #
234
- # == arguments
235
- # x
285
+ # == arguments
286
+ # x
236
287
  # Integer
237
- # description: x coordinate inside object to click
288
+ # description: x coordinate inside object to click
238
289
  # example: 5
239
290
  #
240
- # y
291
+ # y
241
292
  # Integer
242
293
  # description: y coordinate inside object to click
243
294
  # example: 5
244
295
  #
245
- # tap_count
296
+ # tap_count
246
297
  # Integer
247
298
  # description: number of times to tap the screen
248
299
  # example: 1
249
300
  #
250
- # button
301
+ # button
251
302
  # Symbol
252
- # description: button symbol supported values are: :NoButton, :Left, :Right, :Middle
303
+ # description: button symbol supported values are: :NoButton, :Left, :Right, :Middle
253
304
  # example: :Left
254
305
  #
255
306
  # tap_params
256
307
  # Hash
257
308
  # description: parameter that also incorporate all previous tap_object_* commands :command, :behavior_name and :use_tap_screen
258
309
  # example: { }
259
- #
260
- # == returns
310
+ #
311
+ # == returns
261
312
  # NilClass
262
313
  # description: -
263
- # example: -
314
+ # example: nil
264
315
  #
265
- # == exceptions
266
- # TestObjectNotFoundError
267
- # description: If a graphics item is not visible on screen
316
+ # == exceptions
317
+ # TestObjectNotFoundError
318
+ # description: If a graphics item is not visible on screen
268
319
  #
269
- # ArgumentError
320
+ # ArgumentError
270
321
  # description: If coordinates are outside of the object
271
322
  #
272
- def tap_object( x, y, tap_count = 1, button = :Left, tap_params = nil )
323
+ def tap_object( x, y, tap_count = 1, button = :Left, tap_params = nil )
324
+
325
+ begin
273
326
 
274
- begin
275
327
  # New hash format for the parameter. Also incorporates all
276
328
  # previous tap_object_* commands that were redundant.
277
329
  if tap_params.kind_of? Hash
@@ -285,357 +337,489 @@ module MobyBehaviour
285
337
  command_name = 'Tap'
286
338
  behavior_name = 'tap_object'
287
339
  end
288
-
289
- raise ArgumentError.new( "Coordinate x:#{x} x_abs:#{x} outside object." ) unless ( x <= attribute( 'width' ).to_i and x >= 0 )
290
- raise ArgumentError.new( "Coordinate y:#{y} y_abs:#{y} outside object." ) unless ( y <= attribute( 'height' ).to_i and y >= 0 )
291
340
 
292
- command = command_params #in qt_behaviour
293
- command.command_name(command_name)
341
+ raise ArgumentError.new( "Coordinate x:#{x} x_abs:#{x} outside object." ) unless ( x <= attribute( 'width' ).to_i and x >= 0 )
342
+ raise ArgumentError.new( "Coordinate y:#{y} y_abs:#{y} outside object." ) unless ( y <= attribute( 'height' ).to_i and y >= 0 )
294
343
 
295
-
344
+ command = command_params #in qt_behaviour
345
+ command.command_name(command_name)
296
346
 
297
- command.command_params(
298
- 'x' => ( attribute('x_absolute').to_i + x.to_i ).to_s,
299
- 'y' => ( attribute('y_absolute').to_i + y.to_i ).to_s,
300
- 'count' => tap_count.to_s,
301
- 'button' => @@_buttons_map[ button ],
347
+
348
+
349
+ command.command_params(
350
+ 'x' => ( attribute('x_absolute').to_i + x.to_i ).to_s,
351
+ 'y' => ( attribute('y_absolute').to_i + y.to_i ).to_s,
352
+ 'count' => tap_count.to_s,
353
+ 'button' => @@_buttons_map[ button ],
302
354
  'mouseMove' => MobyUtil::Parameter[ @sut.id ][ :in_tap_move_pointer, 'false' ],
303
355
  'useCoordinates' => 'true',
304
- 'useTapScreen' => use_tap_screen
356
+ 'useTapScreen' => use_tap_screen,
357
+ 'x_off' => MobyUtil::Parameter[ @sut.id ][:tap_x_offset , '0' ],
358
+ 'y_off' => MobyUtil::Parameter[ @sut.id ][:tap_y_offset , '0' ]
359
+
305
360
  )
306
361
 
307
- @sut.execute_command(command)
362
+ @sut.execute_command(command)
363
+
364
+ rescue Exception => e
308
365
 
309
- rescue Exception => e
366
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed #{behavior_name} with x \"#{x}\", y \"#{y}\", button \"#{button.to_s}\".;#{identity};#{behavior_name};"
367
+ Kernel::raise e
310
368
 
311
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed #{behavior_name} with x \"#{x}\", y \"#{y}\", button \"#{button.to_s}\".;#{identity};#{behavior_name};"
312
- Kernel::raise e
369
+ end
313
370
 
314
- end
371
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation #{behavior_name} executed successfully with x \"#{x}\", y \"#{y}\", button \"#{button.to_s}\".;#{identity};#{behavior_name};"
315
372
 
316
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation #{behavior_name} executed successfully with x \"#{x}\", y \"#{y}\", button \"#{button.to_s}\".;#{identity};#{behavior_name};"
373
+ nil
317
374
 
318
- nil
375
+ end
319
376
 
320
- end
321
377
 
322
- # Tap down on the screen on the specified coordinates of the object. Given coordinates are relative to the object.
323
- # == params
324
- # x::x coordinate inside object
325
- # y::y coordinate inside object
326
- # button::(optional defaults to :Left) button symbol supported values are: :NoButton, :Left, :Right, :Middle
327
- # == returns
328
- # == raises
329
- # TestObjectNotFoundError:: If a graphics item is not visible on screen
330
- # ArgumentError:: If coordinates are outside of the object
331
- # === examples
332
- # @object.tap_down_object(5, 5)
333
- def tap_down_object( x, y, button = :Left, tap_params = {} )
378
+ # == description
379
+ # Tap down the screen on the specified coordinates of the object. TBA link to generic information about tapping, options read from TDriver parameters etc.
380
+ #
381
+ # == arguments
382
+ # x
383
+ # Integer
384
+ # description: X-coordinate inside the object
385
+ # example: 10
386
+ # y
387
+ # Integer
388
+ # description: Y-coordinate inside the object
389
+ # example: 11
390
+ # button
391
+ # Symbol
392
+ # description: button to tap down
393
+ # example: :Right
394
+ # tap_params
395
+ # Hash
396
+ # description: arguments, link to table TBA
397
+ # example: -
398
+ #
399
+ # == returns
400
+ # NilClass
401
+ # description: -
402
+ # example: nil
403
+ #
404
+ # == exceptions
405
+ # Exception
406
+ # description: see tap_object method for exceptions
407
+ def tap_down_object( x, y, button = :Left, tap_params = {} )
334
408
  tap_params[:behavior_name] = 'tap_down_object'
335
409
  tap_params[:command] = 'MousePress'
336
410
  tap_object(x,y,1,button,tap_params)
337
- end
338
-
339
- # Tap up on the screen on the specified coordinates of the object. Given coordinates are relative to the object.
340
- # == params
341
- # x::x coordinate inside object
342
- # y::y coordinate inside object
343
- # button::(optional defaults to :Left) button symbol supported values are: :NoButton, :Left, :Right, :Middle
344
- # tap_params::(optional, defautlts to Hash} Hash consisting of any additional parameter.
345
- # == returns
346
- # == raises
347
- # TestObjectNotFoundError:: If a graphics item is not visible on screen
348
- # ArgumentError:: If coordinates are outside of the object
349
- # === examples
350
- # @object.tap_up_object(5, 5)
351
- def tap_up_object( x, y = -1, button = :Left, tap_params = {} )
411
+ end
412
+
413
+ # == description
414
+ # Release mouse tap on the specified coordinates of the object. TBA link to generic information about tapping, options read from TDriver parameters etc.
415
+ #
416
+ # == arguments
417
+ # x
418
+ # Integer
419
+ # description: X-coordinate inside the object
420
+ # example: 10
421
+ # y
422
+ # Integer
423
+ # description: Y-coordinate inside the object
424
+ # example: 11
425
+ # button
426
+ # Symbol
427
+ # description: button to tap up
428
+ # example: :Right
429
+ # tap_params
430
+ # Hash
431
+ # description: arguments, link to table TBA
432
+ # example: -
433
+ #
434
+ # == returns
435
+ # NilClass
436
+ # description: -
437
+ # example: nil
438
+ #
439
+ # == exceptions
440
+ # Exception
441
+ # description: see tap_object method for exceptions
442
+ def tap_up_object( x, y = -1, button = :Left, tap_params = {} )
352
443
  tap_params[:behavior_name] = 'tap_up_object'
353
444
  tap_params[:command] = 'MouseRelease'
354
445
  tap_object(x,y,1,button,tap_params)
355
- end
356
-
357
- # Taps the screen on the coordinates of the object for the period of time given is seconds.
358
- # == params
359
- # time::(optional defaults to 1) number of seconds to hold the pointer down.
360
- # button::(optional defaults to :Left) button symbol supported values are: :NoButton, :Left, :Right, :Middle
361
- # == returns
362
- # == raises
363
- # TestObjectNotFoundError:: If a graphics item is not visible on screen
364
- # ArgumentError:: If an invalid button type is given
365
- # === examples
366
- # @object.long_tap(2, :Left)
367
- def long_tap( time = 1, button = :Left, tap_params = {} )
446
+ end
447
+
448
+ # == description
449
+ # Taps the screen on the coordinates of the object for the period of time given is seconds.
450
+ #
451
+ # == arguments
452
+ # time
453
+ # Integer
454
+ # description: Number of seconds to hold the pointer down.
455
+ # example: 5
456
+ # default: 1
457
+ #
458
+ # button
459
+ # Symbol
460
+ # description: Button symbol supported values are: :NoButton, :Left, :Right, :Middle .
461
+ # example: :Right
462
+ # default: :Left
463
+ #
464
+ # tap_params
465
+ # Hash
466
+ # description: Hash with additional tap parameters. Link to table TBA
467
+ # example: {:behavior_name => 'long_tap', :use_tap_screen => true}
468
+ # default: {}
469
+ #
470
+ # == returns
471
+ # NilClass
472
+ # description: -
473
+ # example: -
474
+ #
475
+ # == exceptions
476
+ # ArgumentError
477
+ # description: If tap_params is not a Hash or a Fixnum type
478
+ #
479
+ def long_tap( time = 1, button = :Left, tap_params = {} )
368
480
 
369
481
  logging_enabled = MobyUtil::Logger.instance.enabled
370
482
  MobyUtil::Logger.instance.enabled = false
371
483
 
372
484
 
373
485
  raise ArgumentError.new("First parameter should be time between taps or Hash") unless tap_params.kind_of? Hash or tap_params.kind_of? Fixnum
374
-
375
486
 
376
- begin
377
- tap_down(button, false, tap_params)
487
+
488
+ begin
489
+ tap_down(button, false, tap_params)
378
490
  sleep time
379
491
  tap_up(button, false, tap_params)
380
- rescue Exception => e
381
- MobyUtil::Logger.instance.enabled = logging_enabled
492
+ rescue Exception => e
493
+ MobyUtil::Logger.instance.enabled = logging_enabled
382
494
  MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed long_tap with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap;"
383
495
  Kernel::raise e
384
496
 
385
- end
497
+ end
386
498
  MobyUtil::Logger.instance.enabled = logging_enabled
387
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation long_tap executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap;"
499
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation long_tap executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap;"
388
500
 
389
- nil
501
+ nil
390
502
 
391
503
  end
392
504
 
393
- # Long tap on the screen on the given relative coordinates of the object for the period of time given is seconds.
394
- # == params
395
- # x::x coordinate inside object
396
- # y::y coordinate inside object
397
- # time::(optional defaults to 1) number of seconds to hold the pointer down.
398
- # button::(optional defaults to :Left) button symbol supported values are: :NoButton, :Left, :Right, :Middle
399
- # == returns
400
- # == raises
401
- # TestObjectNotFoundError:: If a graphics item is not visible on screen
402
- # ArgumentError:: If an invalid button type is given
403
- # === examples
404
- # @object.long_tap_object(1, 2, 1, :Left)
405
- def long_tap_object( x, y, time = 1, button = :Left, tap_params = {} )
406
-
407
- begin
408
- tap_down_object(x, y, button, tap_params)
409
- sleep time
410
- tap_up_object(x, y, button, tap_params)
411
- rescue Exception => e
412
-
413
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed long_tap_object with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap_object;"
414
- Kernel::raise e
415
-
416
- end
417
-
418
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation long_tap_object executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap_object;"
419
-
420
- nil
421
-
422
- end
423
-
424
- # Tap down the screen on the coordinates of the object
425
- # == params
426
- # button::(optional defaults to :Left) button symbol supported values are: :NoButton, :Left, :Right, :Middle
427
- # refresh::(optional) If false ui state will not be updated
428
- # == returns
429
- # == raises
430
- # TestObjectNotFoundError:: If a graphics item is not visible on screen
431
- # ArgumentError:: If an invalid button type is given
432
- # === examples
433
- # @object.long_tap_down
434
- def tap_down( button = :Left, refresh = false, tap_params = {} )
435
-
436
- begin
505
+ # == description
506
+ # Long tap on the screen on the given relative coordinates of the object for the period of time given is seconds.
507
+ #
508
+ # == arguments
509
+ # x
510
+ # Integer
511
+ # description: X-coordinate inside the object
512
+ # example: 10
513
+ # y
514
+ # Integer
515
+ # description: Y-coordinate inside the object
516
+ # example: 11
517
+ #
518
+ # time
519
+ # Integer
520
+ # description: Number of seconds to hold the pointer down.
521
+ # example: 5
522
+ # default: 1
523
+ #
524
+ # button
525
+ # Symbol
526
+ # description: Button symbol supported values are: :NoButton, :Left, :Right, :Middle .
527
+ # example: :Right
528
+ # default: :Left
529
+ #
530
+ # tap_params
531
+ # Hash
532
+ # description: Hash with additional tap parameters. Link to table TBA
533
+ # example: {:behavior_name => 'long_tap', :use_tap_screen => true}
534
+ # default: {}
535
+ #
536
+ # == returns
537
+ # NilClass
538
+ # description: -
539
+ # example: -
540
+ #
541
+ # == exceptions
542
+ #
543
+ def long_tap_object( x, y, time = 1, button = :Left, tap_params = {} )
544
+
545
+ begin
546
+ tap_down_object(x, y, button, tap_params)
547
+ sleep time
548
+ tap_up_object(x, y, button, tap_params)
549
+ rescue Exception => e
550
+
551
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed long_tap_object with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap_object;"
552
+ Kernel::raise e
553
+
554
+ end
555
+
556
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation long_tap_object executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap_object;"
557
+
558
+ nil
559
+
560
+ end
561
+
562
+
563
+ # == description
564
+ # Tap down the screen on the coordinates of the object. TBA link to generic information about tapping, options read from TDriver parameters etc.
565
+ #
566
+ # == arguments
567
+ # button
568
+ # Symbol
569
+ # description: button to tap down
570
+ # example: :Right
571
+ # refresh
572
+ # Boolean
573
+ # description: if true, object will be refreshed after tap_down
574
+ # example: true
575
+ # tap_params
576
+ # Hash
577
+ # description: arguments, link to table TBA
578
+ # example: -
579
+ #
580
+ # == returns
581
+ # NilClass
582
+ # description: -
583
+ # example: nil
584
+ #
585
+ # == exceptions
586
+ # TestObjectNotFoundError
587
+ # description: object is not visible on screen
588
+ # ArgumentError
589
+ # description: invalid button
590
+ def tap_down( button = :Left, refresh = false, tap_params = {} )
591
+
592
+ begin
437
593
  use_tap_screen = tap_params[:use_tap_screen].nil? ? MobyUtil::Parameter[ @sut.id][ :use_tap_screen, 'false'] :
438
594
  tap_params[:use_tap_screen].to_s
439
595
  tap_params[:useTapScreen] = use_tap_screen
440
596
 
441
- raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
442
- command = command_params #in qt_behaviour
443
- command.command_name('MousePress')
597
+ raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
598
+ command = command_params #in qt_behaviour
599
+ command.command_name('MousePress')
444
600
 
445
- params = {'button' => @@_buttons_map[button],
446
- 'mouseMove' => MobyUtil::Parameter[ @sut.id ][ :in_tap_move_pointer, 'false' ],
447
- 'useTapScreen' => use_tap_screen}
601
+ params = {
602
+ 'button' => @@_buttons_map[button],
603
+ 'mouseMove' => MobyUtil::Parameter[ @sut.id ][ :in_tap_move_pointer, 'false' ],
604
+ 'useTapScreen' => use_tap_screen,
605
+ 'x_off' => MobyUtil::Parameter[ @sut.id ][:tap_x_offset , '0' ],
606
+ 'y_off' => MobyUtil::Parameter[ @sut.id ][:tap_y_offset , '0' ]
607
+ }
448
608
 
449
609
  if attribute('objectType') == 'Web' or attribute('objectType') == 'Embedded'
450
- params['x'] = center_x
451
- params['y'] = center_y
452
- params['useCoordinates'] = 'true'
453
- end
610
+ params['x'] = center_x
611
+ params['y'] = center_y
612
+ params['useCoordinates'] = 'true'
613
+ end
454
614
  params.merge!(tap_params)
455
615
 
456
616
  command.command_params(params)
457
- @sut.execute_command(command)
617
+ @sut.execute_command(command)
618
+
619
+ self.force_refresh( :id => get_application_id ) if refresh
458
620
 
459
- self.force_refresh( :id => get_application_id ) if refresh
621
+ rescue Exception => e
460
622
 
461
- rescue Exception => e
623
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed tap_down with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_down;"
624
+ Kernel::raise e
462
625
 
463
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed tap_down with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_down;"
464
- Kernel::raise e
626
+ end
465
627
 
466
- end
628
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation tap_down executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_down;"
467
629
 
468
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation tap_down executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_down;"
630
+ nil
469
631
 
470
- nil
632
+ end
471
633
 
472
- end
473
634
 
474
- # Release the pointer on the screen on the coordinates of the object
475
- # == params
476
- # button::(optional defaults to :Left) button symbol supported values are: :NoButton, :Left, :Right, :Middle
477
- # refresh::(optional) If false ui state will not be updated
478
- # == returns
479
- # == raises
480
- # TestObjectNotFoundError:: If a graphics item is not visible on screen
481
- # ArgumentError:: If an invalid button type is given
482
- # === examples
483
- # @object.tap_up
484
- def tap_up( button = :Left, refresh = true, tap_params = {} )
485
635
 
486
- begin
636
+ # == description
637
+ # Release tap on the coordinates of the object. TBA link to generic information about tapping, options read from TDriver parameters etc.
638
+ #
639
+ # == arguments
640
+ # button
641
+ # Symbol
642
+ # description: button to tap down
643
+ # example: :Right
644
+ # refresh
645
+ # Boolean
646
+ # description: if true, object will be refreshed after tap_down
647
+ # example: false
648
+ # tap_params
649
+ # Hash
650
+ # description: arguments, link to table TBA
651
+ # example: -
652
+ #
653
+ # == returns
654
+ # NilClass
655
+ # description: -
656
+ # example: nil
657
+ #
658
+ # == exceptions
659
+ # TestObjectNotFoundError
660
+ # description: object is not visible on screen
661
+ # ArgumentError
662
+ # description: invalid button
663
+ def tap_up( button = :Left, refresh = true, tap_params = {} )
664
+
665
+ begin
487
666
  use_tap_screen = tap_params[:use_tap_screen].nil? ? MobyUtil::Parameter[ @sut.id][ :use_tap_screen, 'false'] :
488
667
  tap_params[:use_tap_screen].to_s
489
668
  tap_params[:useTapScreen] = use_tap_screen
490
669
 
491
- raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
492
- command = command_params #in qt_behaviour
493
- command.command_name('MouseRelease')
670
+ raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
671
+ command = command_params #in qt_behaviour
672
+ command.command_name('MouseRelease')
494
673
  params = {'button' => @@_buttons_map[button], 'useTapScreen' => use_tap_screen}
495
674
 
496
675
  if attribute('objectType') == 'Web' or attribute('objectType') == 'Embedded'
497
- params['x'] = center_x
498
- params['y'] = center_y
499
- params['useCoordinates'] = 'true'
500
- end
676
+ params['x'] = center_x
677
+ params['y'] = center_y
678
+ params['useCoordinates'] = 'true'
679
+ params['x_off'] = MobyUtil::Parameter[ @sut.id ][:tap_x_offset , '0' ]
680
+ params['y_off'] = MobyUtil::Parameter[ @sut.id ][:tap_y_offset , '0' ]
681
+
682
+ end
501
683
  params.merge!(tap_params)
502
684
 
503
685
  command.command_params(params)
504
686
 
505
687
 
506
- @sut.execute_command(command)
507
- self.force_refresh({:id => get_application_id}) if refresh
688
+ @sut.execute_command(command)
689
+ self.force_refresh({:id => get_application_id}) if refresh
690
+
691
+ rescue Exception => e
508
692
 
509
- rescue Exception => e
510
-
511
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed tap_up with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_up;"
512
- Kernel::raise e
693
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed tap_up with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_up;"
694
+ Kernel::raise e
513
695
 
514
- end
696
+ end
515
697
 
516
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation tap_up executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_up;"
698
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation tap_up executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_up;"
517
699
 
518
- nil
700
+ nil
519
701
 
520
- end
702
+ end
521
703
 
522
- # TODO: [2009-04-02] Remove deprevated methods?
704
+ # TODO: [2009-04-02] Remove deprevated methods?
523
705
 
524
- # warning: TestObject#press is deprecated; use TestObject#tap
706
+ # warning: TestObject#press is deprecated; use TestObject#tap
525
707
  # == deprecated
526
708
  # 0.8.x
527
709
  # == description
528
710
  # TestObject#press is deprecated, use TestObject#tap instead.
529
- def press( tap_count = 1, button = :Left )
711
+ def press( tap_count = 1, button = :Left )
530
712
 
531
- $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#press is deprecated; use TestObject#tap"
713
+ $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#press is deprecated; use TestObject#tap"
532
714
 
533
- begin
534
- raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
715
+ begin
716
+ raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
535
717
 
536
- command = command_params #in qt_behaviour
718
+ command = command_params #in qt_behaviour
537
719
 
538
- command.command_name('Tap')
720
+ command.command_name('Tap')
539
721
 
540
- command.command_params(
541
- 'x' => center_x,
542
- 'y' => center_y,
543
- 'count' => tap_count.to_s,
544
- 'button' => @@_buttons_map[button],
545
- 'mouseMove'=>'true'
722
+ command.command_params(
723
+ 'x' => center_x,
724
+ 'y' => center_y,
725
+ 'count' => tap_count.to_s,
726
+ 'button' => @@_buttons_map[button],
727
+ 'mouseMove'=>'true',
728
+ 'x_off' => MobyUtil::Parameter[ @sut.id ][:tap_x_offset , '0' ],
729
+ 'y_off' => MobyUtil::Parameter[ @sut.id ][:tap_y_offset , '0' ]
546
730
  )
547
731
 
548
- @sut.execute_command(command)
732
+ @sut.execute_command(command)
549
733
 
550
- rescue Exception => e
734
+ rescue Exception => e
551
735
 
552
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed press with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};press;"
553
- Kernel::raise e
736
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed press with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};press;"
737
+ Kernel::raise e
554
738
 
555
- end
739
+ end
556
740
 
557
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation press executed successfully with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};press;"
741
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation press executed successfully with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};press;"
558
742
 
559
- nil
743
+ nil
560
744
 
561
- end
745
+ end
562
746
 
563
- # TestObject#long_press is deprecated; use TestObject#long_tap
747
+ # TestObject#long_press is deprecated; use TestObject#long_tap
564
748
  # == deprecated
565
749
  # 0.8.x
566
750
  # == description
567
751
  # TestObject#long_press is deprecated, use TestObject#long_tap instead.
568
- def long_press( time = 1, button = :Left )
752
+ def long_press( time = 1, button = :Left )
753
+
754
+ $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#long_press is deprecated; use TestObject#long_tap"
569
755
 
570
- $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#long_press is deprecated; use TestObject#long_tap"
756
+ begin
757
+ long_tap(time, button)
758
+ rescue Exception => e
759
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed long_press with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_press;"
760
+ Kernel::raise e
761
+ end
571
762
 
572
- begin
573
- long_tap(time, button)
574
- rescue Exception => e
575
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed long_press with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_press;"
576
- Kernel::raise e
577
- end
763
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation long_press executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_press;"
578
764
 
579
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation long_press executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_press;"
580
-
581
- nil
765
+ nil
582
766
 
583
- end
767
+ end
584
768
 
585
- # TestObject#hold is deprecated; use TestObject#tap_down
769
+ # TestObject#hold is deprecated; use TestObject#tap_down
586
770
  # == deprecated
587
771
  # 0.8.x
588
772
  # == description
589
773
  # TestObject#hold is deprecated, use TestObject#tap_down instead.
590
- def hold(button = :Left, refresh = true)
774
+ def hold(button = :Left, refresh = true)
591
775
 
592
- $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#hold is deprecated; use TestObject#tap_down"
776
+ $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#hold is deprecated; use TestObject#tap_down"
593
777
 
594
- begin
778
+ begin
595
779
 
596
- tap_down(button, refresh)
780
+ tap_down(button, refresh)
597
781
 
598
- rescue Exception => e
782
+ rescue Exception => e
599
783
 
600
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed hold with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};hold;"
601
- Kernel::raise e
784
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed hold with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};hold;"
785
+ Kernel::raise e
602
786
 
603
- end
604
-
605
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation hold executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};hold;"
606
-
607
- nil
787
+ end
788
+
789
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation hold executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};hold;"
790
+
791
+ nil
608
792
 
609
- end
793
+ end
610
794
 
611
- # TestObject#release is deprecated; use TestObject#tap_up
795
+ # TestObject#release is deprecated; use TestObject#tap_up
612
796
  # == deprecated
613
797
  # 0.8.x
614
798
  # == description
615
799
  # TestObject#release is deprecated, use TestObject#tap_up instead.
616
- def release( button = :Left, refresh = true )
800
+ def release( button = :Left, refresh = true )
617
801
 
618
- $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#release is deprecated; use TestObject#tap_up"
802
+ $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#release is deprecated; use TestObject#tap_up"
619
803
 
620
- begin
804
+ begin
621
805
 
622
- tap_up(button, refresh)
806
+ tap_up(button, refresh)
623
807
 
624
- rescue Exception => e
808
+ rescue Exception => e
625
809
 
626
- MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed release with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};release;"
627
- Kernel::raise e
810
+ MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed release with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};release;"
811
+ Kernel::raise e
628
812
 
629
- end
813
+ end
630
814
 
631
- MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation release executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};release;"
632
-
633
- nil
815
+ MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation release executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};release;"
634
816
 
635
- end
817
+ nil
636
818
 
637
- =begin
638
- private
819
+ end
820
+
821
+ =begin
822
+ private
639
823
 
640
824
  def center_x
641
825
  x = self.attribute('x_absolute').to_i
@@ -649,11 +833,11 @@ module MobyBehaviour
649
833
  height = self.attribute('height').to_i
650
834
  y = y + (height/2)
651
835
  y.to_s
652
- end
653
- =end
836
+ end
837
+ =end
654
838
 
655
- # enable hooking for performance measurement & debug logging
656
- MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
839
+ # enable hooking for performance measurement & debug logging
840
+ MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
657
841
 
658
842
  end # Widget
659
843