# EditMultiGraphics

This function inserts an interactive control into the spreadsheet for manipulating a variable list of Controls functions:

- EditAnnulus

- EditCircle

- EditCompositeRegion

- EditLine

- EditMaskedRegion

- EditPoint

- EditPolygon

- EditPolylinePath

- EditRegion

When you click the control, the display switches to Interactive Graphics Mode, where you can adjust the position of all of the referenced Controls functions. You must edit each Controls function individually while all of the overlay graphics of the other Controls functions are still displayed. For more information, see Interactive Graphics Mode.

You can edit EditMultiGraphics from the WebHMI.

Note:

- After entering Interactive Graphics Mode to adjust the region of interest of the Controls functions, click OK in the Job Edit Toolbar, or press the ENTER key to accept the changes. To leave Interactive Graphics Mode without accepting the changes, click Cancel in the Job Edit Toolbar.
- The EditMultiGraphics function does not have a property sheet. The function is based on three parameters and a variable list of arguments that reference existing Controls functions.
- The maximum cell length allowed in a cell is 255 characters. If more than 255 characters are used to specify the variable arguments, an error message is displayed. When using a string to specify the variable arguments, use a cell range.
- The EditMultiGraphics ignores any functions in its variable list which are either #ERR or conditionally disabled, and only displays the Controls functions that can be edited.
- To display the overlay graphics of the referenced Controls functions, ensure that the Show parameter of the referenced functions is set to display the overlay graphics at all times. Otherwise, the overlay graphics are only be displayed when the EditMultiGraphics function is highlighted or the individual cell containing the overlay graphics is highlighted.

Inputs

Parameter | Description
--- | ---
Image | This parameter must reference a spreadsheet cell that contains an Image data structure; by default, this parameter references A0, the cell containing the AcquireImage Image data structure. This parameter can also reference other Image data structures, such as those returned by the Vision Tool Image functions or Coordinate Transforms Functions. For more information, see Image or Coordinate Transforms Functions. Note: The EditMultiGraphics function must share the same Image reference as the Controls functions it is referencing. If one or more of the Controls functions that are being referenced by the EditMultiGraphics function do not share the same Image reference, the function will result in a #ERR state.
Name | Specifies a text label for the EditMultiGraphics control element in the spreadsheet.
Show Labels |
Note: This parameter is currently not implemented and has no effect.
Edit Control 0 | Specifies a cell reference to a Controls function. The EditMultiGraphics function supports the following Controls functions: EditAnnulus, EditCircle, EditCompositeRegion, EditLine, EditMaskedRegion, EditPoint, EditPolygon, EditPolylinePath and EditRegion. For more information, see Controls Functions. Note: The maximum number of Controls functions that you can reference is determined by which of the following scenarios occurs first: the maximum number of cell references a function can accept (255 references), or the maximum string length of a cell's expression (255 characters).
Edit Control 1 | Specifies a cell reference to a Controls function.

Outputs

Results | An EditMultiGraphics control. The function returns #ERR if the function is references a cell that does not contain a supported Controls function or the Image reference of the EditMultiGraphics function does not match the Image reference of the referenced Controls functions.