Macro Icon Properties

From Flowcode Help
Jump to navigationJump to search

<sidebar>Sidebar: Icon Properties</sidebar>

Btn Macro.gif Gen Macro Flowchart Icon 01.png Gen Macro Icon Properties 01.png

Macros are split into Macros and Component/Simulation macros.


Component macros are pre-defined macros supplied with the components. For example LCD macros are used to display numbers and characters on the LCD display.

Component macros are only available for use with that particular component.

Component macros have hatched outer bands on the icon.


Simulation macros are simulation-only Component macros - they provide a similar purpose, although they can only be used in simulation and cannot be run on hardware.


Macros (explained here) are those designed and created by the user.

Macros can be exported and imported allowing users to build up macro libraries of common or important tasks.

On Macros the outer bands are clear and not hatched.


Macros

Macros are sections of code, that can be used and reused in projects.

Macros allow complex tasks to be handled by code blocks and they can be imported and exported.


The macro properties dialog allows users to select and create macros.


Adding a Macro

Select the Macro to use from the list, or click on Create new macro to begin creating a new macro to add to the list.

Add in any parameters required, and select a return value if required.


Clicking on the OK button completes the process and closes the dialog.

Clicking on the OK and edit button completes the process, closes the dialog and opens the selected macro for editing.


Parameters

If the device macro requires any parameters then these can be entered in this field. They can be numeric values or existing variables. Clicking on the down arrow allows you to select an existing variable or to create a new one.

The parameter details will list the parameter type. Parameters must be of the required type to be accepted.

Note that a full set of parameters must be provided.


Return value

If the device macro returns a value then you can assign that value to an existing variable for use later in the flowchart. If the function returns a value but you do not wish to retrieve it then leave this field empty.

The variable type of the return value will be listed. A variable of the specified type must be used to accept the return value.


Create New Macro button

Select this button to create a new macro within the flowchart.


OK & Edit Macro button

Clicking this button will open up the chosen macro to allow it to be viewed or edited.


Video instructions

See the Macros video to learn how to call a macro from a selection of existing macros and input a macro parameter using the Macro icon.

{{#ev:youtube|SlWkK1mwyJQ|640}}