Mercurial > octave
view scripts/plot/util/gca.m @ 33637:8f0c4370af99 default tip
fix building without qscintilla
* gui-settings.cc (read_lexer_settings): fixed typo, def instead of dev
* settings-dialog.cc (update_lexer): dito
author | Torsten Lilge <ttl-octave@mailbox.org> |
---|---|
date | Sun, 02 Jun 2024 18:52:33 +0200 |
parents | 2e484f9f1f18 |
children |
line wrap: on
line source
######################################################################## ## ## Copyright (C) 2005-2024 The Octave Project Developers ## ## See the file COPYRIGHT.md in the top-level directory of this ## distribution or <https://octave.org/copyright/>. ## ## 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 ## <https://www.gnu.org/licenses/>. ## ######################################################################## ## -*- texinfo -*- ## @deftypefn {} {@var{h} =} gca () ## Return a handle to the current axes object. ## ## The current axes is the default target for graphics output. In the case ## of a figure with multiple axes, @code{gca} returns the last created axes ## or the last axes that was clicked on with the mouse. ## ## If no current axes object exists, create one and return its handle. The ## handle may then be used to examine or set properties of the axes. For ## example, ## ## @example ## @group ## ax = gca (); ## set (ax, "position", [0.5, 0.5, 0.5, 0.5]); ## @end group ## @end example ## ## @noindent ## creates an empty axes object and then changes its location and size in the ## figure window. ## ## Note: To find the current axes without creating a new axes object if it ## does not exist, query the @qcode{"CurrentAxes"} property of a figure. ## ## @example ## get (gcf, "currentaxes"); ## @end example ## @seealso{gcf, gco, gcbf, gcbo, get, set} ## @end deftypefn function h = gca () h = get (gcf (), "currentaxes"); if (isempty (h)) h = axes (); endif endfunction %!test %! hf = figure ("visible", "off"); %! ax = axes (); %! unwind_protect %! assert (gca, ax); %! unwind_protect_cleanup %! close (hf); %! end_unwind_protect