macaroni

confirm

Description:
The confirm executor is used to display a yes/no text message to the user with a message box type experience . The dialog will have two buttons, Yes and No.

Parent: execute, then, else

Value (simple form): string specifying the text message to display
Value (key/value form):

• confirm: string, required, specifying the text message to display
• title: string, optional, specifying the confirm dialog box title (default is null)
• image: string, specifying the name of an image to display in confirm dialog box (default is null)
• timeout: time, optional, specifying the amount of time, after which the confirm will be dismissed (default is null)
  • if timeout is null, the confirm will not be automatically dismissed
  • if timeout has no unit, milliseconds is assumed
• default: boolean, optional, specifying the default button if timeout is supplied and confirm is automatically dismissed

# simple form
- confirm: (string)

# simple example
- confirm: Are you sure?

# key/value form
- confirm: (string, required)
  title: (string, optional)
  image: (string, optional)
  timeout: (time, optional)
  default: (boolean, optional)

# key/value example
- confirm: Are you sure?
  timeout: 5s
  default: true

EXAMPLE

# confirm and then reset a file to it's default value
commands:
- triggers:
  - reset favorites ini file
  execute:
  - confirm: Are you sure you want to reset the favorites text file?
  - file:
      name: '{folders.Desktop}\favorites.txt'
      write: |
        [favorites]
        count=0
  - display: '{folders.Desktop}\favorites.txt has been reset!'

Status: ✅ IMPLEMENTED (caveats: image, and timeout not yet functional)

Additional information:

• More than one confirm can be displayed on the screen at a time, from different command executions