Set Object Property

This action sets properties of form object, like width, height and color.

About group identifies the selected action.

• Name: allows you to define a custom action name. This makes actions easily recognizable on the solution's list of actions. By default, the action name is taken from its type.
• Description: custom information about the action. Enter a description to explain the purpose and role of action in a solution.
• Action type: read-only information about the selected action type.

Settings group defines the properties to be set:

• Object name: form object to be edited. Drop-down list contains objects on the form.

• Property: defines the form object property to be set. The availability of properties depends on the currently selected object.

  Tip

  The settings take effect after the form is run and the assigned event takes place.

  Property	Role	Applicability
  X	Sets distance from left/right form border.	All form objects.
  Y	Sets distance from top/bottom form border.	All form objects.
  Width	Sets object width.	All form objects.
  Height	Sets object height.	All form objects.
  Enabled	Makes the object enabled or disabled.	All form objects.
  Visible	Makes the object visible or invisible.	All form objects.
  Font name	Changes font name to the selected one.	All form objects with textual content.
  Font size	Changes font size to the selected value.	All form objects with textual content.
  Font style	Changes font style to the selected one.	All form objects with textual content.
  Font color	Changes font color to the selected one.	All form objects with textual content.
  Color	Changes the object color to the selected one.	All form objects, except Database Navigator, Picture.
  Visible columns	Makes a selection of table columns visible. Columns are visible in the same order as entered in the Value field.	Database Table.

• Value: comma-separated values. Use the “ character if value name includes a comma.

Action Execution and Error Handling

Each action can be set as a conditional action. Conditional actions only run when the defined conditions allow them to be run. To define these conditions, click Show execution and error handling options.

Execution options are:

• Enabled: specifies if the action is enabled or disabled. Only enabled actions will execute. This functionality may be used while testing a form.
• Condition: defines one-line programming expression that must provide a Boolean value (true or false). When the result of the expression is true, the action will execute. Condition offers a way to avoid executing actions every time.

Error handling options are:

• Ignore failure: specifies whether an error should be ignored. If enabled, the execution of actions continues even if the current action fails.

  Note

  Nested actions that depend on the current action do not execute in case of a failure. The execution of actions continues with the next action on the same level as the current action. The error is logged but does not break the execution of the action.

Example

At the end of printing, you might want to send the status update to an external application using the HTTP Request action. If the printing action fails, action processing stops. In order to execute the reporting even after the failed print action, the Print Label action must have the option Ignore failure enabled.

• Save error to variable: allows you to select or create a variable to save the error to. The same cause of the error is also saved to internal variables ActionLastErrorId and ActionLastErrorDesc.