Learn about how to use the code completion (auto suggest) features in SoundFlow's code editor to discover new UI elements and actions

In SoundFlow's script editor, we have code completion built in. This means, once you start typing, it will help you show which actions are possible. You start any action by typing sf. and the main categories will show up.

If you want to work on something UI (User Interface) related, ie. working with apps such as Pro Tools, Cubase, Finder, Chrome etc., go to the UI subcategory by further writing ui.

If you dive into proTools, you can start finding actions that are supported in there. Here I started typing window, because then I'm shown all the UI elements (the blue icon) I can dive into, and in purple, all the actions I can invoke directly on the UI element I have now chosen (sf.ui.proTools in this case).

Let's say I want to work on something in the automationWindow. Then I continue to write that (or select it by using the keyboard down and enter keys):

Now I can see there are some UI elements (autoMatchLatchedControlsButton and captureButton). I can also see some actions, some related to dialog stuff, some to element... stuff. But the scrollbars are hidden in my screenshot, in reality there are many more UI elements. Most of these are probably called something with ...Button, so I can search for these by continuing my typing with button.:

Nice. That gave me an even better overview of the buttons in our automationWindow. Let's say I want to do something with the previewButton, so I type that, and then I know I want to click it, so I look further through any click actions:

Now I'm thinking I want to click the preview button while holding down the command modifier. Fortunately, this is supported if we choose the mouseClickElement action. If I just wanted to invoke the button normally with no modifier keys, it would be better to use elementClick since that action doesn't simulate the mouse, so it doesn't need the button to be visible. But, since we're wanting to combine a click and a keyboard action, it needs to be mouse simulated.

Having chosen my command, I type mouseClickElement followed by empty parentheses () and a semicolon to terminate the line ;:

But, remember that I wanted to ask the action to hold down the command key? We do this by providing an object (which is denoted by curly braces with initializers within { ... }) with the arguments we want to pass to our mouseClickElement action.

So I type an opening curly brace { and the script editor automatically fills out the closing brace }

I now hit Enter and F2 (while being between the curly braces) to get the list of possible settings, or arguments for this action:

Cool! So we can see that isCommand is a property we can control, and we assume that isCommand controls whether or not the command key is held down. Let's type isCommand followed by a : to designate that we wanna set the value for isCommand to something.

Here I set the isCommand to 'yes' but the red line clearly means I'm doing something wrong, so lets hold the mouse over the red line to see what's wrong.

If you read a little through this, the important information is in the bottom part:

Type '"yes"' is not assignable to type 'boolean'.

Ok, so we need to provide a boolean value to isCommand. boolean means true or false. So since we want the command key to be held down, let's fill in with true instead of the string 'yes':

And, tadaa! we have created our first little script.Next lesson would be to try out finding different UI elements and combining them with different actions to see what's possible.

Did this answer your question?