MATLAB Function Reference Previous page   Next Page

Get current axes handle



h = gca returns the handle to the current axes for the current figure. If no axes exists, MATLAB creates one and returns its handle. You can use the statement

if you do not want MATLAB to create an axes if one does not already exist.

Current Axes

The current axes is the target for graphics output when you create axes children. The current axes is typically the last axes used for plotting or the last axes clicked on by the mouse. Graphics commands such as plot, text, and surf draw their results in the current axes. Changing the current figure also changes the current axes.

See Also

axes, cla, gcf, findobj

figure CurrentAxes property

Finding and Identifying Graphics Objects for related functions

Previous page  gamma, gammainc, gammaln gcbf Next page

© 1994-2005 The MathWorks, Inc.