Internationalisation
Bundled Plugins API
Sheet
​
Sheet UI Module.

API Overview

  • Functions - API calls offered directly by the extension
  • ​matches​
  • Constructors - API calls which return an object, typically one that offers API methods
  • ​Sheet​
  • Fields - Variables which can only be accessed from an object returned by a constructor
  • ​cancel​
  • ​default​
  • ​title​
  • Methods - API calls which can only be made on an object returned by a constructor
  • ​containsText​
  • ​doCancel​
  • ​doDefault​
  • ​doHide​
  • ​doPress​
  • ​hide​
  • ​pressCancel​
  • ​pressDefault​

API Documentation

Functions

​matches​

Signature
cp.ui.Sheet.matches(element) -> boolean
Type
Function
Description
Checks to see if an element matches what we think it should be.
Parameters
  • element - An axuielementObject to check.
Returns
  • true if matches otherwise false

Constructors

​Sheet​

Signature
cp.ui.Sheet(parent, uiFinder) -> Sheet
Type
Constructor
Description
Creates a new Sheet instance.
Parameters
  • parent - The parent object.
  • uiFinder - The UI, either a cp.prop or a function.
Returns
  • A new Browser object.

Fields

​cancel​

Signature
cp.ui.Sheet.cancel <cp.ui.Button>
Type
Field
Description
The cancel Button for the Sheet.

​default​

Signature
cp.ui.Sheet.default <cp.ui.Button>
Type
Field
Description
The default Button for the Sheet.

​title​

Signature
cp.ui.Sheet.title <cp.prop: string>
Type
Field
Description
Gets the title of the sheet.

Methods

​containsText​

Signature
cp.ui.Sheet:containsText(value[, plain]) -> boolean
Type
Method
Description
Checks if there are any child text elements containing the exact text or pattern, from beginning to end.
Parameters
  • textPattern - The text pattern to check.
  • plain - If true, the text will be compared exactly, otherwise it will be considered to be a pattern. Defaults to false.
Returns
  • true if an element's AXValue matches the text pattern exactly.

​doCancel​

Signature
cp.ui.Sheet:doCancel() -> cp.rx.go.Statement <boolean>
Type
Method
Description
Attempts to hide the Sheet (if visible) by pressing the Cancel button.
Parameters
  • None
Returns
  • A Statement to execute, resolving to true if the button was present and clicked, otherwise false.

​doDefault​

Signature
cp.ui.Sheet:doDefault() -> cp.rx.go.Statement <boolean>
Type
Method
Description
Attempts to press the default Button.
Parameters
  • None
Returns
  • A Statement to execute, resolving to true if the button was present and clicked, otherwise false.

​doHide​

Signature
cp.ui.Sheet:doHide() -> cp.rx.go.Statement <boolean>
Type
Method
Description
Attempts to hide the Sheet (if visible) by pressing the Cancel button.
Parameters
  • None
Returns
  • A Statement to execute, resolving to true if the button was present and clicked, otherwise false.

​doPress​

Signature
cp.ui.Sheet:doPress(buttonFromLeft) -> cp.rx.go.Statement <boolean>
Type
Method
Description
Attempts to press the indicated button from left-to-right, if it can be found.
Parameters
  • buttonFromLeft - The number of the button from left-to-right.
Returns
  • a Statement to execute, resolving in true if the button was found and pressed, otherwise false.

​hide​

Signature
cp.ui.Sheet:hide() -> none
Type
Method
Description
Hides the sheet by pressing the "Cancel" button, if it exists.
Parameters
  • None
Returns
  • None

​pressCancel​

Signature
cp.ui.Sheet:pressCancel() -> self, boolean
Type
Method
Description
Presses the Cancel button.
Parameters
  • None
Returns
  • The Sheet object.
  • true if successful, otherwise false.

​pressDefault​

Signature
cp.ui.Sheet:pressDefault() -> self, boolean
Type
Method
Description
Presses the Default button.
Parameters
  • None
Returns
  • The Sheet object.
  • true if successful, otherwise false.