iptGetPointerBehavior

Retrieve pointer behavior from graphics object

Syntax

pointerBehavior = iptGetPointerBehavior(obj)

Description

pointerBehavior = iptGetPointerBehavior(obj) returns the pointer behavior structure associated with the graphics object obj. A pointer behavior structure contains function handles that interact with a figure's pointer manager (see iptPointerManager) to control what happens when the figure's mouse pointer moves over and then exits the object.

Input Arguments

collapse all

`obj` — Graphics object
figure | axes | uipanel | image

Graphics object, specified as a handle to a figure, axes, uipanel, or image graphics objects.

Output Arguments

collapse all

`pointerBehavior` — Pointer behavior
struct | `[]`

Pointer behavior, returned as a structure with three fields.

Field	When Called
`enterFcn`	Called when the mouse pointer moves over the object.
`traverseFcn`	Called once when the mouse pointer moves over the object, and called again each time the mouse moves within the object.
`exitFcn`	Called when the mouse pointer leaves the object.

If obj does not contain a pointer behavior structure, then iptGetPointerBehavior returns [].

Version History

Introduced in R2006a