Mercurial > octave-antonio
view scripts/gui/msgbox.m @ 20071:98d10871018a
Accept CREATEMODE argument for errordlg, warndlg, msgbox (bug #44775).
* errordlg.m: Update docstring. Use varargin to pass extra argument to msg_box.
* warndlg.m: Update docstring. Use varargin to pass extra argument to msg_box.
* msgbox.m: Update docstring.
* message_dialog.m: Issue warning if unimplemented CREATEMODE argument given.
Issue warning if icon type "custom" is used.
author | Rik <rik@octave.org> |
---|---|
date | Sat, 11 Apr 2015 08:18:42 -0700 |
parents | 0e1f5a750d00 |
children |
line wrap: on
line source
## Copyright (C) 2010, 2013 Martin Hepperle ## ## 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} {@var{h} =} msgbox (@var{msg}) ## @deftypefnx {Function File} {@var{h} =} msgbox (@var{msg}, @var{title}) ## @deftypefnx {Function File} {@var{h} =} msgbox (@var{msg}, @var{title}, @var{icon}) ## @deftypefnx {Function File} {@var{h} =} msgbox (@dots{}, @var{createmode}) ## Display @var{msg} using a message dialog box. ## ## The message may have multiple lines separated by newline characters ## ("\n"), or it may be a cellstr array with one element for each ## line. The optional input @var{title} (character string) can be used to ## decorate the dialog caption. ## ## The optional argument @var{icon} selects a dialog icon. ## It can be one of @qcode{"none"} (default), @qcode{"error"}, ## @qcode{"help"}, or @qcode{"warn"}. ## ## The return value is always 1. ## ## Compatibility Note: The optional argument @var{createmode} is accepted for ## @sc{matlab} compatibility, but is not implemented. # ## @seealso{errordlg, helpdlg, inputdlg, listdlg, questdlg, warndlg} ## @end deftypefn function retval = msgbox (msg, title = "", varargin) if (nargin < 1 || nargin > 4) print_usage (); endif retval = message_dialog ("msgbox", msg, title, varargin{:}); endfunction %!demo %! disp('- test msgbox message only.'); %! msgbox("Below, you should see 3 lines:\nline #1\nline #2, and\nline #3."); %!demo %! disp('- test msgbox message and caption.'); %! msgbox('You should see a single line.','A msgbox');