axes

gca

Get 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.

The current axes is the target for graphics output when you create axes children. Graphics commands such as plot, text, and surf draw their results in the current axes. Changing the current figure also changes the current axes.