Barrel Button

This is a test for the barrel button feature of a Windows pen device.

Test name

• Barrel Button

Core requirements tested

• Device.Input.Digitizer.Pen.BarrelButton

Test purpose

• Verifies that the pen reports barrel button flag correctly.

Tools required

• None.

Validation steps

1. While the pen is out of range, press and hold the barrel button.

2. Continue to hold the barrel button, then bring the pen in hover range over the green rectangle. After a few milliseconds, the green rectangle will turn yellow.

3. Continue to lower the pen so that it makes contact with the yellow rectangle. Keep in contact until the yellow rectangle turns green (at least 2 seconds).

4. Lift the pen back into hover range. Keep there until the green rectangle turns yellow (at least 2 seconds).

5. Slowly take the pen out of range. You may now release the barrel button.

Here's a screenshot from the Barrel Button test.

Common error messages

• "Barrel button went off after being detected"

  Occurs if the barrel button is unexpectedly transitioned from on to off in the middle of the test.

• "Barrel button was not detected in time"

  Occurs if the barrel button was not detected within the allotted time of the pen being placed in hover range.

• "Barrel button was not detected before contact was made"

  Occurs if the pen made contact as instructed in step 3, but the barrel button was never detected.

• "Pen lost contact before rectangle changed color!"

  Occurs when user lifts pen up in step 4 too early, before the rectangle changes back to green.

• "The contact did not begin in the correct location"

  Occurs if the pen stroke does not begin in the green rectangle.

Passing criteria

• 1/1 test iterations must pass for test to succeed.