Image Processing Toolbox™

iptPointerManager - Create pointer manager in figure

Syntax

iptPointerManager(hFigure) iptPointerManager(hFigure, 'disable') iptPointerManager(hFigure, 'enable')

Description

iptPointerManager(hFigure) creates a pointer manager in the specified figure. The pointer manager controls pointer behavior for any Handle Graphics objects in the figure that contain pointer behavior structures. Use iptSetPointerBehavior to associate a pointer behavior structure with a particular object to define specific actions that occur when the mouse pointer moves over and then leaves the object. See iptSetPointerBehavior for more information.

Note iptPointerManager considers not just the object the pointer is over. iptpointermanager traverses up the HG hierarchy from the object to find the first object in the hierarchy that contains a pointer behavior structure and executes that object's pointer behavior function. For example...

iptPointerManager(hFigure, 'disable') disables the figure's pointer manager.

iptPointerManager(hFigure, 'enable') enables and updates the figure's pointer manager.

If the figure already contains a pointer manager, iptPointerManager(hFigure) does not create a new one. It has the same effect as iptPointerManager(hFigure, 'enable').

Examples

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);

iptPointerManager - Create pointer manager in figure

Syntax

Description

Examples

See Also