Buttons: Common Parameters
Buttons are the primary control elements in MetaGrid Pro. Each button triggers user-defined actions ranging from keyboard shortcuts to multi-step macros.
Button Types
MetaGrid Pro has 4 button types:
- Standard Button — Triggers a macro on tap.
- Momentary Switch — Activates macros on touch-down and touch-up.
- Latching Switch — Toggles between On and Off states on each tap.
- Menu Button — Displays a menu of up to 10 macros.
By default, new grids are populated with standard buttons.
Change the Button Type
Step 1: Open the Inspector
Tap a button in Edit Mode to open the Inspector.
Step 2: Open the Type Selector
Tap the object type name (e.g., Button) at the top-left of the Inspector.
Step 3: Select a Type
Choose the desired button type from the list.
Shared Controls
All button types share these controls in the Inspector:
- More (ellipsis icon, top-right of Inspector) — Opens an actions menu with options such as Copy Macro: Mac to Win, Copy Macro: Win to Mac, and Reset Button to restore defaults.
- Share — Exports or imports the button via Dropbox or the iOS share sheet.
Common Parameters
Macro
Tap the Mac or Win field to open the Macro Editor and assign a macro for each platform.
Layout
Choose from 12 button layouts. Available options depend on button size and include Text Only, Icon & Underlay Shape, Icon and Text Below, and others.
Style Presets
Select from 11 preconfigured color styles to apply a consistent look.
Text
- Text — The label displayed on the button.
- Size — Font size.
- Style — Normal or italic.
- Weight — Ranges from Ultralight to Black.
- Width — Compressed, Condensed, Standard, or Expanded.
- Text Color — Sets the text color.
- Transparency — Adjusts text opacity.
Background
- Fill Type — Solid, 2-step gradient, or 3-step gradient.
- Color selectors — Set the solid color or the start, middle, and end colors for gradients.
- Gradient Type — Vertical, horizontal, diagonal, or radial.
- Transparency — Adjusts background opacity.
Icon
- Icon — Opens the Icon Selector to browse and choose an image.
- Icon Color — Sets the icon color.
- Custom Image Should Be Tinted — Applies a color tint to imported custom images.
- Transparency — Adjusts icon opacity.
Underlay Shape
- Underlay Shape — Select a background shape image for the button.
- Underlay Shape Color — Sets the shape color.
- Transparency — Adjusts shape opacity.
Border
- Show Border — Toggles border visibility.
- Border Width — Sets the border thickness.
- Border Color — Sets the border color.
Effects
- Enable Shadow — Adds a drop shadow to the button.
- Shadow Color — Sets the shadow color.
- Enable Glowing — Activates a glow effect around the button.
Target Application
Set the Target Application to direct the macro to a specific app on your computer. This lets individual buttons on the same grid trigger macros in different applications.