Create pointer manager in figure
iptPointerManager(
creates a pointer manager in the specified figure,hFigure
)hFigure
. If the figure contains apointer behavior structure, then the pointer manager controls the pointer behavior for graphics objects in the figure.
UseiptSetPointerBehavior
to associate a pointer behavior structure with a particular object and to define specific actions that occur when the mouse pointer moves over and then leaves the object.
iptPointerManager(
disables the figure's pointer manager.hFigure
,'disable')
iptPointerManager(
enables and updates the figure's pointer manager.hFigure
,'enable')
Plot a line. Create a pointer manager in the figure. Then, associate a pointer behavior structure with the line object in the figure that changes the mouse pointer into a fleur whenever the pointer is over it.
h = plot(1:10); iptPointerManager(gcf); enterFcn = @(hFigure,currentPoint)set(hFigure,'Pointer','fleur'); iptSetPointerBehavior(h,enterFcn);
If a figure already contains a pointer manager, theniptPointerManager(hFigure)
does not create a new pointer manager. The syntax has the same behavior asiptPointerManager(hFigure,'enable')
.
iptPointerManager
considers not just the object the pointer is over, but all objects in the figure.iptPointerManager
searches the graphics objects hierarchy to find the first object that contains a pointer behavior structure. TheiptPointerManager
then executes that object's pointer behavior function. For more information, seeGraphics Object Hierarchy.
For example, you could set the pointer to be a fleur and associate that pointer with the axes. Then, when you slide the pointer into the figure window, it will initially be the default pointer, then change to a fleur when you cross into the axes, and remain a fleur when you slide over the objects parented to the axes.
If you specify a pointer behavior usingiptSetPointerBehavior
and then change the figure pointer without usingiptSetPointerBehavior
, then theiptPointerManager
may not update to reflect the new behavior. Some ways to change the figure pointer without usingiptSetPointerBehavior
include using ROI objects such asPolygon
, another graphics object, another custom UI, or code that modifies the pointer from within a callback.