Mercurial > octave-antonio
view scripts/plot/util/axes.m @ 20115:7e0e8fb16201
Overhaul close.m to add "force" argument (bug #44324)
* close.m: Emit an error if there is no figure handle or "all" argument given.
Check for "force" argument and delete the requested figure handles rather than
calling closereqfcn. Add BIST input validation tests. Add new calling forms
and explanation of "force" to docstring.
author | Rik <rik@octave.org> |
---|---|
date | Wed, 22 Apr 2015 08:41:50 -0700 |
parents | 9fc020886ae9 |
children |
line wrap: on
line source
## Copyright (C) 2005-2015 John W. Eaton ## ## This file is part of Octave. ## ## Octave is free software; you can redistribute it and/or modify it ## under the terms of the GNU General Public License as published by ## the Free Software Foundation; either version 3 of the License, or (at ## your option) any later version. ## ## Octave is distributed in the hope that it will be useful, but ## WITHOUT ANY WARRANTY; without even the implied warranty of ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU ## General Public License for more details. ## ## You should have received a copy of the GNU General Public License ## along with Octave; see the file COPYING. If not, see ## <http://www.gnu.org/licenses/>. ## -*- texinfo -*- ## @deftypefn {Function File} {} axes () ## @deftypefnx {Function File} {} axes (@var{property}, @var{value}, @dots{}) ## @deftypefnx {Function File} {} axes (@var{hax}) ## @deftypefnx {Function File} {@var{h} =} axes (@dots{}) ## Create an axes object and return a handle to it, or set the current ## axes to @var{hax}. ## ## Called without any arguments, or with @var{property}/@var{value} pairs, ## construct a new axes. For accepted properties and corresponding ## values, @pxref{XREFset,,set}. ## ## Called with a single axes handle argument @var{hax}, the function makes ## @var{hax} the current axis. It also restacks the axes in the ## corresponding figure so that @var{hax} is the first entry in the list ## of children. This causes @var{hax} to be displayed on top of any other ## axes objects (Z-order stacking). ## ## @seealso{gca, set, get} ## @end deftypefn ## Author: jwe function h = axes (varargin) if (nargin == 0 || nargin > 1) ## Parent figure idx = find (strcmpi (varargin(1:2:end), "parent"), 1, "first"); if (! isempty (idx) && length (varargin) >= 2*idx) cf = varargin{2*idx}; varargin([2*idx-1, 2*idx]) = []; else cf = gcf (); endif ## If there is an annotation axes currently on top of the figure ## children stack, we will put it back on top do_restack = false; ch = allchild (cf); hax = ch(isaxes (ch)); idx = find (strcmp (get (hax, "tag"), "scribeoverlay")); if (idx == 1) hover = hax(idx); do_restack = true; endif ## Create an axes object. htmp = __go_axes__ (cf, varargin{:}); if (__is_handle_visible__ (htmp)) set (ancestor (cf, "figure"), "currentaxes", htmp); endif ## Restack if necessary if (do_restack) restack_axes (hover, cf); endif else ## ARG is axes handle. htmp = varargin{1}; if (isscalar (htmp) && isaxes (htmp)) cf = ancestor (htmp, "figure"); if (__is_handle_visible__ (htmp)) set (0, "currentfigure", cf); set (cf, "currentaxes", htmp); endif ## restack restack_axes (htmp, cf); else error ("axes: H must be a scalar axes handle"); endif endif if (nargout > 0) h = htmp; endif endfunction function restack_axes (h, cf) show = get (0, "showhiddenhandles"); set (0, "showhiddenhandles", "on"); unwind_protect ch = get (cf, "children"); hax = ch(isaxes (ch)); ch(isaxes (ch)) = [h; hax(hax != h)]; set (cf, "children", ch); unwind_protect_cleanup set (0, "showhiddenhandles", show); end_unwind_protect endfunction