| // Copyright 2017 Google Inc. All Rights Reserved. |
| // |
| // Licensed under the Apache License, Version 2.0 (the "License"); |
| // you may not use this file except in compliance with the License. |
| // You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| |
| import 'web_element.dart'; |
| |
| class MouseButton { |
| /// The primary button is usually the left button or the only button on |
| /// single-button devices, used to activate a user interface control or select |
| /// text. |
| static const MouseButton primary = const MouseButton(0); |
| |
| /// The auxiliary button is usually the middle button, often combined with a |
| /// mouse wheel. |
| static const MouseButton auxiliary = const MouseButton(1); |
| |
| /// The secondary button is usually the right button, often used to display a |
| /// context menu. |
| static const MouseButton secondary = const MouseButton(2); |
| |
| final int value; |
| |
| /// [value] for a mouse button is defined in |
| /// https://w3c.github.io/uievents/#widl-MouseEvent-button |
| const MouseButton(this.value); |
| } |
| |
| abstract class Mouse { |
| /// Click any mouse button (at the coordinates set by the last moveTo). |
| void click([MouseButton button]); |
| |
| /// Click and hold any mouse button (at the coordinates set by the last |
| /// moveTo command). |
| void down([MouseButton button]); |
| |
| /// Releases the mouse button previously held (where the mouse is currently at). |
| void up([MouseButton button]); |
| |
| /// Double-clicks at the current mouse coordinates (set by moveTo). |
| void doubleClick(); |
| |
| /// Move the mouse. |
| /// |
| /// If [element] is specified and [xOffset] and [yOffset] are not, will move |
| /// the mouse to the center of the [element]. |
| /// |
| /// If [xOffset] and [yOffset] are specified, will move the mouse that distance |
| /// from its current location. |
| /// |
| /// If all three are specified, will move the mouse to the offset relative to |
| /// the top-left corner of the [element]. |
| /// All other combinations of parameters are illegal. |
| void moveTo({WebElement element, int xOffset, int yOffset}); |
| } |