This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

iptPointerManager

Create pointer manager in figure

Syntax

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

Description

example

iptPointerManager(hFigure) creates a pointer manager in the specified figure. If the figure contains a pointer behavior structure, then the pointer manager controls the pointer behavior for graphics objects in the figure. 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.

Note

If the figure already contains a pointer manager, then iptPointerManager(hFigure) does not create a new pointer manager. The syntax has the same behavior as iptPointerManager(hFigure,'enable').

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

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

Examples

Create Pointer Manager in Figure with Line Object

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

Input Arguments

collapse all

Figure, specified as a Figure object. For more information, see figure.

Tips

  • 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. The iptPointerManager then executes that object's pointer behavior function. For more information, see Graphics Object Hierarchy (MATLAB).

    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.

Introduced in R2006a