Figure Properties - SERC

gco
2gco
Purpose Return handle of current object
Syntax h = gco
h = gco(figure_handle)
Description h = gco returns the handle of the current object.
2-958
h = gco(figure_handle) returns the value of the current object for the figure
specified by figure_handle.
Remarks The current object is the last object clicked on, excluding uimenus. If the mouse
click did not occur over a figure child object, the figure becomes the current
object. MATLAB stores the handle of the current object in the figure’s
CurrentObject property.
The CurrentObject of the CurrentFigure does not always indicate the object
whose callback is being executed. Interruptions of callbacks by other callbacks
can change the CurrentObject or even the CurrentFigure. Some callbacks,
such as CreateFcn and DeleteFcn, and uimenu Callback, intentionally do not
update CurrentFigure or CurrentObject.
gcbo provides the only completely reliable way to retrieve the handle to the
object whose callback is executing, at any point in the callback function,
regardless of the type of callback or of any previous interruptions.
Examples This statement returns the handle to the current object in figure window 2:
h = gco(2)
See Also gca, gcbo, gcf
The root object description
“Finding and Identifying Graphics Objects” for related functions