MATLAB Function Reference

gca - Current axes handle

Syntax

h = gca

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

get(gcf,'CurrentAxes')

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

gamma, gammainc, gammaln

gcbf