Main Content


Set text label for point ROI object

setString is not recommended. With the new Point ROI, set the value of the Label property instead. For more information, see Compatibility Considerations.



setString(h,text) places a text label, text, to the lower right of the point ROI object, h.


collapse all

Display an image and create a point ROI.

h = impoint(gca,100,200);

Set the label of the ROI.

setString(h,"My point label");

Input Arguments

collapse all

Point ROI object, specified as an impoint object.

Text label, specified as a string scalar or character vector.

Data Types: string | char

Version History

Introduced before R2006a

collapse all

R2018b: setString is not recommended

Starting in R2018b, a new set of ROI objects replaces the existing set of ROI objects. The new objects provide more functional capabilities, such as face color transparency. The new classes also support events that you can use to respond to changes in your ROI such as moving or being clicked. Although there are no plans to remove the old ROI objects at this time, switch to the new ROIs to take advantage of the additional capabilities and flexibility. For more information on creating ROIs using the new ROI functions, see Create ROI Shapes.

To specify a label for a point ROI, assign a value to the Label property of the ROI. Use the LabelVisible property to control the visibility of the label.

Update Code

Update all instances of setString method.

Discouraged UsageRecommended Replacement

This example specifies a label for the point ROI using the setString method.

h = impoint(gca,[100 100]);
setString(h,"My Label");

Create a point ROI using the new ROI objects and replace use of the getString method with setting the value of the Label property of the ROI. You can control the visibility of the label using the LabelVisible property. All the new ROI objects support a Label property.

h = drawpoint(gca,"Position",[100 100]);
h.Label = "My Label";