MATLAB Function Reference    

Return handle of current object



h = gco returns the handle of the current object.

h = gco(figure_handle) returns the value of the current object for the figure specified by figure_handle.


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.


This statement returns the handle to the current object in figure window 2:

See Also

gca, gcbo, gcf

The root object description

Finding and Identifying Graphics Objects for related functions

  gcf genpath