MATLAB Function Reference Previous page   Next Page
gca

Get current axes handle

Syntax

Description

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.