Module: MobyBehaviour::QT::Widget

Includes:
Behaviour
Defined in:
lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb

Overview

description

Widget specific behaviours

behaviour

QtWidget

requires

testability-driver-qt-sut-plugin

input_type

touch

sut_type

qt

sut_version

*

objects

*

Instance Method Summary collapse

Methods included from Behaviour

#command_params

Instance Method Details

#hold(button = :Left, refresh = true) ⇒ Object

TestObject#hold is deprecated; use TestObject#tap_down

deprecated

0.8.x

description

TestObject#hold is deprecated, use TestObject#tap_down instead.



802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 802

def hold(button = :Left, refresh = true)

  $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#hold is deprecated; use TestObject#tap_down"

  begin

    tap_down(button, refresh)

  rescue Exception

    $logger.behaviour "FAIL;Failed hold with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};hold;"

    raise

  end

  $logger.behaviour "PASS;Operation hold executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};hold;"

  nil

end

#long_press(time = 1, button = :Left) ⇒ Object

TestObject#long_press is deprecated; use TestObject#long_tap

deprecated

0.8.x

description

TestObject#long_press is deprecated, use TestObject#long_tap instead.



775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 775

def long_press( time = 1, button = :Left )

  $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#long_press is deprecated; use TestObject#long_tap"

  begin

    long_tap(time, button)

  rescue Exception

    $logger.behaviour "FAIL;Failed long_press with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_press;"

    raise

  end

  $logger.behaviour "PASS;Operation long_press executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_press;"

  nil

end

#long_tap(time = 1, button = :Left, tap_params = {}) ⇒ Object

description

Taps the screen on the coordinates of the object for the period of time given is seconds.

arguments

time

Integer
 description: Number of seconds to hold the pointer down.
 example: 5
 default: 1

button

Symbol
 description: Button symbol supported values are: :NoButton, :Left, :Right, :Middle .
 example: :Right
 default: :Left

tap_params

Hash
 description: Hash with additional tap parameters. Link to table TBA
 example: {:behavior_name => 'long_tap', :use_tap_screen => true}
 default: {}

returns

NilClass

description: -
example: -

exceptions

ArgumentError

description: If tap_params is not a Hash or a Fixnum type

Raises:

  • (ArgumentError) 


486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 486

def long_tap( time = 1, button = :Left, tap_params = {} )

  logging_enabled = $logger.enabled
  $logger.enabled = false
    
  raise ArgumentError.new("First parameter should be time between taps or Hash") unless tap_params.kind_of? Hash or tap_params.kind_of? Fixnum

  begin
    ens = param_set_configured?(tap_params, :ensure_event)
    tap_params[:ensure_event] = false
    if ens
      ensure_event(:retry_timeout => 5, :retry_interval => 0.5) {
            tap_down(button, false, tap_params)
            sleep time
            tap_up(button, false, tap_params)
          }
    else
      tap_down(button, false, tap_params)
      sleep time
      tap_up(button, false, tap_params)
    end

      
  rescue Exception

    $logger.enabled = logging_enabled

    $logger.behaviour "FAIL;Failed long_tap with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap;"

    raise

  end
  $logger.enabled = logging_enabled
  $logger.behaviour "PASS;Operation long_tap executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap;"

  nil

end

#long_tap_object(x, y, time = 1, button = :Left, tap_params = {}) ⇒ Object

description

Long tap on the screen on the given relative coordinates of the object for the period of time given is seconds.

arguments

x

Integer
 description: X-coordinate inside the object
 example: 10

y

Integer
 description: Y-coordinate inside the object
 example: 11

time

Integer
 description: Number of seconds to hold the pointer down.
 example: 5
 default: 1

button

Symbol
 description: Button symbol supported values are: :NoButton, :Left, :Right, :Middle .
 example: :Right
 default: :Left

tap_params

Hash
 description: Hash with additional tap parameters. Link to table TBA
 example: {:behavior_name => 'long_tap', :use_tap_screen => true}
 default: {}

returns

NilClass

description: -
example: -

exceptions



563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 563

def long_tap_object( x, y, time = 1, button = :Left, tap_params = {} )

  begin

    tap_down_object(x, y, button, tap_params)
    sleep time
    tap_up_object(x, y, button, tap_params)

  rescue Exception

    $logger.behaviour "FAIL;Failed long_tap_object with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap_object;"

    raise

  end

  $logger.behaviour "PASS;Operation long_tap_object executed successfully with time \"#{time.to_s}\", button \"#{button.to_s}\".;#{identity};long_tap_object;"

  nil

end

#move_mouse(move_params = false) ⇒ Object

description

Moves the mouse to the object it was called on.

arguments

move_params

Boolean
 description: if true will cause the framework to refresh the UI state
 example: true

returns

NilClass

description: -
example: -

examples



63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 63

def move_mouse( move_params = false )

  $stderr.puts "#{ caller(0).last.to_s } warning: move_mouse(boolean) is deprecated; use move_mouse(Hash)" if move_params == true

  begin
    # Hide all future params in a hash
    use_tap_screen = false
    if move_params.kind_of? Hash
      use_tap_screen = move_params[:use_tap_screen].nil? ? sut_parameters[ :use_tap_screen, 'false'] : move_params[:use_tap_screen].to_s
    else
      use_tap_screen = sut_parameters[ :use_tap_screen, 'false']
    end
    command = command_params #in qt_behaviour
    command.command_name('MouseMove')

    if attribute('objectType') == 'Web' or attribute('objectType') == 'Embedded'
      params = {
        'x' => center_x, 
        'y' => center_y, 
        'useCoordinates' => 'true',
        'useTapScreen' => use_tap_screen,
        'x_off' => sut_parameters[:tap_x_offset , '0' ],
        'y_off' => sut_parameters[:tap_y_offset , '0' ]
      }
    else
      params = {'useTapScreen' => use_tap_screen.to_s}
    end
    command.command_params(params)

    execute_behavior(move_params, command)

  rescue Exception

    $logger.behaviour "FAIL;Failed to mouse_move"

    raise

  end

  $logger.behaviour "PASS;Operation mouse_move executed successfully"

  nil

end

#press(tap_count = 1, button = :Left) ⇒ Object

warning: TestObject#press is deprecated; use TestObject#tap

deprecated

0.8.x

description

TestObject#press is deprecated, use TestObject#tap instead.



733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 733

def press( tap_count = 1, button = :Left )

  $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#press is deprecated; use TestObject#tap"

  begin
    raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)

    command = command_params #in qt_behaviour

    command.command_name('Tap')

    command.command_params(
                           'x' => center_x,
                           'y' => center_y,
                           'count' => tap_count.to_s,
                           'button' => @@_buttons_map[button],
                           'mouseMove'=>'true',
                           'x_off' => sut_parameters[:tap_x_offset , '0' ],
                           'y_off' => sut_parameters[:tap_y_offset , '0' ]
                           )

    @sut.execute_command(command)

  rescue Exception

    $logger.behaviour "FAIL;Failed press with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};press;"

    raise

  end

  $logger.behaviour "PASS;Operation press executed successfully with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};press;"

  nil

end

#release(button = :Left, refresh = true) ⇒ Object

TestObject#release is deprecated; use TestObject#tap_up

deprecated

0.8.x

description

TestObject#release is deprecated, use TestObject#tap_up instead.



829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 829

def release( button = :Left, refresh = true )

  $stderr.puts "#{ caller(0).last.to_s } warning: TestObject#release is deprecated; use TestObject#tap_up"

  begin

    tap_up(button, refresh)

  rescue Exception

    $logger.behaviour "FAIL;Failed release with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};release;"

    raise

  end

  $logger.behaviour "PASS;Operation release executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};release;"

  nil

end

#tap(tap_params = 1, interval = nil, button = :Left) ⇒ Object

description

Taps the screen on the coordinates of the object.

arguments

tap_params

Hash
 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.
 example: -

interval

Integer
 description: DEPRECATED, use hash key :interval instead
 example: -

button

Symbol
 description: DEPRECATED, use hash key :button instead
 example: -

tables

tap_params_table

title: Hash argument tap_params
description: Valid keys for argument tap_params as hash
|Key|Description|Type|Example|Default|
|:button|Button to use for tapping|Symbol|:Right|:Left|
|:duration|Duration in seconds for a single left button press, all other arguments ignored|Numeric|0.1|-|
|:interval|This method sleeps tap_count times interval|Integer|2|1|
|:tap_count|Number of taps to do|Integer|2|1|
|:use_tap_screen|Should tapping be done on screen or as mouse event to the object|Boolean|true|see TDriver parameters table below|
|:ensure_event|Verify that an event is sent to the target object. Retry if not received by target|Boolean|true|false|

tdriver_params_table

title: Default values read from tdriver parameters
description: These setting values are read from tdriver_parameters.xml
|Name|Description|Default if missing from parameters|
|use_tap_screen|See :use_tap_screen above|false|
|in_tap_move_pointer|Wether to actually move mouse pointer to tap coordinates|false|
|:ensure_event|Verify that an event is sent to the target object. Retry if not received by target|false|

returns

NilClass

description: -
example: -

exceptions

TestObjectNotFoundError

description: object is not visible on screen

ArgumentError

description: Invalid button or non-integer interval



155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 155

def tap( tap_params = 1, interval = nil, button = :Left )
  # tapMeasure = Time.now
  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - tap start"

  # delegate duration taps to grouped behaviors
  if tap_params.kind_of?(Hash) && !tap_params[:duration].nil?
    @sut.group_behaviours(tap_params[:duration], get_application) {
      tap_down
      tap_up
    }
    return
  end

  begin
    #for api compatibility
    if interval and interval.kind_of?(Symbol)
      button = interval
      interval = nil
    end

    # Another one, first param a has for the rest
    if tap_params.kind_of?(Hash)
      interval = tap_params[:interval]
      if tap_params[:button].nil?
        button = :Left
      else
        button = tap_params[:button]
      end

      tap_count = tap_params[:tap_count].nil? ? 1 : tap_params[:tap_count]
      use_tap_screen = tap_params[:use_tap_screen].nil? ? sut_parameters[ :use_tap_screen, 'false'] : tap_params[:use_tap_screen].to_s
      
    else
      tap_count = tap_params

      use_tap_screen = sut_parameters[ :use_tap_screen, 'false']
    end

    raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
    if interval
      raise ArgumentError.new( "Invalid interval must be an integer." ) unless interval.kind_of?(Integer)
    end

    command = command_params #in qt_behaviour
    command.command_name('Tap')

    params = {
      'count' => tap_count.to_s,
      'button' => @@_buttons_map[button],
      'mouseMove' => sut_parameters[ :in_tap_move_pointer, 'false' ],
      'useTapScreen' => use_tap_screen,
      'x_off' => sut_parameters[:tap_x_offset , '0' ],
      'y_off' => sut_parameters[:tap_y_offset , '0' ]
    }


    if interval
      params[:interval] = (interval.to_f * 1000).to_i
    end

    # puts "tap: " + (Time.now - tapMeasure).to_s + " s - before webs"

    if attribute('objectType') == 'Web' or attribute('objectType') == 'Embedded'
      #params['obj_x'] = (center_x.to_i - 1).to_s
      #params['obj_y'] = (center_y.to_i - 1).to_s
      params['x'] = (center_x.to_i - 1).to_s
      params['y'] = (center_y.to_i - 5).to_s #make sure we do not tap between two line links
      params['useCoordinates'] = 'true'
				end

    # puts "tap: " + (Time.now - tapMeasure).to_s + " s - before 2 webs"

    if(attribute('objectType') == 'Web')
      #check that type is not QWebFrame and that QWebFrame is found for object
      if type != "QWebFrame" and attributes.key?('webFrame')
        # puts "tap: " + (Time.now - tapMeasure).to_s + " s - Not q webframe"
        elemens_xml_data, unused_rule = @test_object_adapter.get_objects( @sut.xml_data, { :id => attribute('webFrame')}, true )
        object_xml_data = elemens_xml_data[0]
        object_attributes = @test_object_adapter.test_object_attributes(object_xml_data)
        x_absolute = object_attributes['x_absolute'].to_i 
        y_absolute = object_attributes['y_absolute'].to_i
        width = object_attributes['width'].to_i 
        height = object_attributes['height'].to_i  
        horizontalScrollBarHeight =  object_attributes['horizontalScrollBarHeight'].to_i
        verticalScrollBarWidth = object_attributes['verticalScrollBarWidth'].to_i

        # puts "tap: " + (Time.now - tapMeasure).to_s + " s - x_a(#{x_absolute}), y_a(#{y_absolute}), w(#{width}), h(#{height})"


        if(object_attributes['baseUrl'] != "" and (
             (center_x.to_i < x_absolute) or
             (center_x.to_i > x_absolute + width - verticalScrollBarWidth) or
             (center_y.to_i < y_absolute) or
             (center_y.to_i > y_absolute + height - horizontalScrollBarHeight)
           )
          )
          #puts "web element scroll"
          scroll(0,0,1) # enable tap centralization
          #puts "web element force refresh in tap"
          force_refresh({:id => get_application_id})
          tap(tap_params, interval, button)
          return
        end
      end
    end
    command.command_params(params)

    # puts "tap: " + (Time.now - tapMeasure).to_s + " s - tap about to execute "
    execute_behavior(tap_params, command)

    # puts "tap: " + (Time.now - tapMeasure).to_s + " s - executed"
    #do not allow operations to continue untill taps done
    if interval
      sleep interval * tap_count
    end

  rescue Exception

    $logger.behaviour "FAIL;Failed tap with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};tap;"

    raise

  end

  $logger.behaviour "PASS;Operation tap executed successfully with tap_count \"#{tap_count}\", button \"#{button.to_s}\".;#{identity};tap;"

  # puts "tap: " + (Time.now - tapMeasure).to_s + " s - tapping ending"


  nil

end

#tap_down(button = :Left, refresh = false, tap_params = {}) ⇒ Object

description

Tap down the screen on the coordinates of the object. TBA link to generic information about tapping, options read from TDriver parameters etc.

arguments

button

Symbol
 description: button to tap down
 example: :Right

refresh

Boolean
 description: if true, object will be refreshed after tap_down
 example: true

tap_params

Hash
 description: arguments, link to table TBA
 example: -

returns

NilClass

description: -
example: nil

exceptions

TestObjectNotFoundError

description: object is not visible on screen

ArgumentError

description: invalid button



613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 613

def tap_down( button = :Left, refresh = false, tap_params = {} )

  begin
    use_tap_screen = tap_params[:use_tap_screen].nil? ? sut_parameters[ :use_tap_screen, 'false'] : tap_params[:use_tap_screen].to_s
    tap_params[:useTapScreen] = use_tap_screen

    raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
    command = command_params #in qt_behaviour
    command.command_name('MousePress')

    params = {
      'button' => @@_buttons_map[button],
      'mouseMove' => sut_parameters[ :in_tap_move_pointer, 'false' ],
      'useTapScreen' => use_tap_screen,
      'x_off' => sut_parameters[:tap_x_offset , '0' ],
      'y_off' => sut_parameters[:tap_y_offset , '0' ]
    }

    if attribute('objectType') == 'Web' or attribute('objectType') == 'Embedded'
      params['x'] = center_x
      params['y'] = center_y
      params['useCoordinates'] = 'true'
    end
    params.merge!(tap_params)

    command.command_params(params)
    execute_behavior(tap_params, command)

    force_refresh( :id => get_application_id ) if refresh

  rescue Exception

    $logger.behaviour "FAIL;Failed tap_down with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_down;"

    raise

  end

  $logger.behaviour "PASS;Operation tap_down executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_down;"

  nil

end

#tap_down_object(x, y, button = :Left, tap_params = {}) ⇒ Object

description

Tap down the screen on the specified coordinates of the object. TBA link to generic information about tapping, options read from TDriver parameters etc.

arguments

x

Integer
 description: X-coordinate inside the object
 example: 10

y

Integer
 description: Y-coordinate inside the object
 example: 11

button

Symbol
 description: button to tap down
 example: :Right

tap_params

Hash
 description: arguments, link to table TBA
 example: -

returns

NilClass

description: -
example: nil

exceptions

Exception

description: see tap_object method for exceptions



414
415
416
417
418
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 414

def tap_down_object( x, y, button = :Left, tap_params = {} )
  tap_params[:behavior_name] = 'tap_down_object'
  tap_params[:command] = 'MousePress'
  tap_object(x,y,1,button,tap_params)
end

#tap_object(x, y, tap_count = 1, button = :Left, tap_params = nil) ⇒ Object

description

Taps the screen on the specified coordinates of the object. Given coordinates are relative to the object.

arguments

x

Integer
 description: x coordinate inside object to click
 example: 5

y

Integer
 description: y coordinate inside object to click
 example: 5

tap_count

Integer
 description: number of times to tap the screen
 example: 1

button

Symbol
 description: button symbol supported values are: :NoButton, :Left, :Right, :Middle
 example: :Left

tap_params

Hash
 description: parameter that also incorporate all previous tap_object_* commands :command, :behavior_name and :use_tap_screen
 example: { }

returns

NilClass

description: -
example: nil

exceptions

TestObjectNotFoundError

description: If a graphics item is not visible on screen

ArgumentError

description: If coordinates are outside of the object



330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 330

def tap_object( x, y, tap_count = 1, button = :Left, tap_params = nil )

  begin

    # New hash format for the parameter. Also incorporates all
    # previous tap_object_* commands that were redundant.
    if tap_params.kind_of? Hash
      command_name = tap_params[:command].nil? ? 'Tap' : tap_params[:command]
      behavior_name = tap_params[:behavior_name].nil? ? 'tap_object' : tap_params[:behavior_name]

      use_tap_screen = tap_params[:use_tap_screen].nil? ? sut_parameters[ :use_tap_screen, 'false'] : tap_params[:use_tap_screen].to_s
    else
      use_tap_screen = sut_parameters[ :use_tap_screen, 'false']
      command_name = 'Tap'
      behavior_name = 'tap_object'
    end

    raise ArgumentError.new( "Coordinate x:#{x} x_abs:#{x} outside object." ) unless ( x <= attribute( 'width' ).to_i and x >= 0 )
    raise ArgumentError.new( "Coordinate y:#{y} y_abs:#{y} outside object." ) unless ( y <= attribute( 'height' ).to_i and y >= 0 )

    command = command_params #in qt_behaviour
    command.command_name(command_name)



    command.command_params(
                           'x' => ( attribute('x_absolute').to_i + x.to_i ).to_s,
                           'y' => ( attribute('y_absolute').to_i + y.to_i ).to_s,
                           'count' => tap_count.to_s,
                           'button' => @@_buttons_map[ button ],
                           'mouseMove' => sut_parameters[ :in_tap_move_pointer, 'false' ],
                           'useCoordinates' => 'true',
                           'useTapScreen' => use_tap_screen,
                           'x_off' => sut_parameters[:tap_x_offset , '0' ],
                           'y_off' => sut_parameters[:tap_y_offset , '0' ]
                           
                           )

    execute_behavior(tap_params, command)

  rescue Exception

    $logger.behaviour "FAIL;Failed #{behavior_name} with x \"#{x}\", y \"#{y}\", button \"#{button.to_s}\".;#{identity};#{behavior_name};"

    raise

  end

  $logger.behaviour "PASS;Operation #{behavior_name} executed successfully with x \"#{x}\", y \"#{y}\", button \"#{button.to_s}\".;#{identity};#{behavior_name};"

  nil

end

#tap_up(button = :Left, refresh = true, tap_params = {}) ⇒ Object

description

Release tap on the coordinates of the object. TBA link to generic information about tapping, options read from TDriver parameters etc.

arguments

button

Symbol
 description: button to tap down
 example: :Right

refresh

Boolean
 description: if true, object will be refreshed after tap_down
 example: false

tap_params

Hash
 description: arguments, link to table TBA
 example: -

returns

NilClass

description: -
example: nil

exceptions

TestObjectNotFoundError

description: object is not visible on screen

ArgumentError

description: invalid button



686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 686

def tap_up( button = :Left, refresh = true, tap_params = {} )

  begin
    use_tap_screen = tap_params[:use_tap_screen].nil? ? sut_parameters[ :use_tap_screen, 'false'] : tap_params[:use_tap_screen].to_s
    tap_params[:useTapScreen] = use_tap_screen

    raise ArgumentError.new( "Invalid button." ) unless @@_valid_buttons.include?(button)
    command = command_params #in qt_behaviour
    command.command_name('MouseRelease')
    params = {'button' => @@_buttons_map[button], 'useTapScreen' => use_tap_screen}

    if attribute('objectType') == 'Web' or attribute('objectType') == 'Embedded'
      params['x'] = center_x
      params['y'] = center_y
      params['useCoordinates'] = 'true'
      params['x_off'] = sut_parameters[:tap_x_offset , '0' ]
      params['y_off'] = sut_parameters[:tap_y_offset , '0' ]

    end
    params.merge!(tap_params)

    command.command_params(params)

    execute_behavior(tap_params, command)
    force_refresh({:id => get_application_id}) if refresh

  rescue Exception

    $logger.behaviour "FAIL;Failed tap_up with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_up;"

    raise

  end

  $logger.behaviour "PASS;Operation tap_up executed successfully with with button \"#{button.to_s}\", refresh \"#{refresh.to_s}\".;#{identity};tap_up;"

  nil

end

#tap_up_object(x, y = -1,, button = :Left, tap_params = {}) ⇒ Object

description

Release mouse tap on the specified coordinates of the object. TBA link to generic information about tapping, options read from TDriver parameters etc.

arguments

x

Integer
 description: X-coordinate inside the object
 example: 10

y

Integer
 description: Y-coordinate inside the object
 example: 11

button

Symbol
 description: button to tap up
 example: :Right

tap_params

Hash
 description: arguments, link to table TBA
 example: -

returns

NilClass

description: -
example: nil

exceptions

Exception

description: see tap_object method for exceptions



449
450
451
452
453
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/widget.rb', line 449

def tap_up_object( x, y = -1, button = :Left, tap_params = {} )
  tap_params[:behavior_name] = 'tap_up_object'
  tap_params[:command] = 'MouseRelease'
  tap_object(x,y,1,button,tap_params)
end