Skip to content
REFERENCE

U.REGISTER_IMAGE

Summary

Registers images so they can be updated by name in U.UPDATE_IMAGE and also used as buttons in U.SET_CLICKVALS

Syntax

=U.REGISTER_IMAGE(range, name, [clickable], [filter])

Parameters

Parameter Required Description
range Yes The range where the image to be registered can be found. If not specified then the workbook is searched for the name specified in the 'name' parameter
name Yes The name to be applied to the registered image. If not specified, an image found in the specified range will be registered with its current name
[clickable] No Set to TRUE to make the image available as a button in U.SET_CLICKVALS
[filter] No Substrings of the image text and/or alternative text that can be used to identify the specific image to register in cases where the specified range contains multiple images

Behavior

The documented public interface is supported by the current U Add-in source signature and the maintained Usage Examples workbook. Optional parameters are shown in square brackets in the syntax above; omit the brackets when entering a formula.

Return Value

Returns the function result or action status described by the formula and parameters above. The maintained sources do not define a narrower, stable return contract for this function.

Examples

=U.REGISTER_IMAGE(B103,E105,E106,E107)

=U.REGISTER_IMAGE()

Notes

  • Formula examples are preserved from maintained workbook usage and normalized to the current U. prefix.
  • Complete formulas demonstrate working patterns; they do not imply that undocumented option values are supported.
  • Where maintained sources do not specify every accepted value, default, or error message, this page does not infer one.
  • For functions that perform actions, use a visible trigger or supported block/throttle parameter to avoid unintended repetition during recalculation.