1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
## 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{cstr} =} inputdlg (@var{prompt})
## @deftypefnx {Function File} {@var{cstr} =} inputdlg (@var{prompt}, @var{title})
## @deftypefnx {Function File} {@var{cstr} =} inputdlg (@var{prompt}, @var{title}, @var{rowscols})
## @deftypefnx {Function File} {@var{cstr} =} inputdlg (@var{prompt}, @var{title}, @var{rowscols}, @var{defaults})
## Return user input from a multi-textfield dialog box in a cell array of
## strings, or an empty cell array if the dialog is closed by the Cancel
## button.
##
## Inputs:
##
## @table @var
## @item prompt
## A cell array with strings labeling each text field. This input is required.
##
## @item title
## String to use for the caption of the dialog. The default is
## @qcode{"Input Dialog"}.
##
## @item rowscols
## Specifies the size of the text fields and can take three forms:
##
## @enumerate
## @item a scalar value which defines the number of rows used for each text field.
##
## @item a vector which defines the individual number of rows used for each text field.
##
## @item a matrix which defines the individual number of rows and columns used for each text field. In the matrix each row describes a single text field. The first column specifies the number of input rows to use and the second column specifies the text field width.
## @end enumerate
##
## @item defaults
## A list of default values to place in each text fields. It must be a cell
## array of strings with the same size as @var{prompt}.
## @end table
## @seealso{errordlg, helpdlg, listdlg, msgbox, questdlg, warndlg}
## @end deftypefn
function cstr = inputdlg (prompt, title = "Input Dialog", varargin)
if (nargin < 1 || nargin > 4)
print_usage ();
endif
if (iscell (prompt))
## Silently extract only char elements
prompt = prompt(cellfun ("isclass", prompt, "char"));
elseif (ischar (prompt))
prompt = {prompt};
else
error ("inputdlg: PROMPT must be a character string or cellstr array");
endif
if (! ischar (title))
error ("inputdlg: TITLE must be a character string");
endif
switch (numel (varargin))
case 0
linespec = 1;
defaults = cellstr (cell (size (prompt)));
case 1
linespec = varargin{1};
defaults = cellstr (cell (size (prompt)));
case 2
linespec = varargin{1};
defaults = varargin{2};
endswitch
## specification of text field sizes as in Matlab
## Matlab requires a matrix for linespec, not a cell array...
## rc = [1,10; 2,20; 3,30];
## c1 c2
## r1 1 10 first text field is 1x10
## r2 2 20 second text field is 2x20
## r3 3 30 third text field is 3x30
if (! isnumeric (linespec))
error ("inputdlg: ROWSCOLS must be numeric");
endif
if (isscalar (linespec))
## only scalar value in lineTo, copy from linespec and add defaults
rowscols = zeros (numel (prompt), 2);
## cols
rowscols(:,2) = 25;
rowscols(:,1) = linespec;
elseif (isvector (linespec))
if (numel (linespec) == numel (prompt))
## only one column in lineTo, copy from vector linespec and add defaults
rowscols = zeros (numel (prompt), 2);
## rows from colum vector linespec, columns are set to default
rowscols(:,2) = 25;
rowscols(:,1) = linespec(:);
else
error ("inputdlg: ROWSCOLS vector does not match size of PROMPT");
endif
elseif (ismatrix (linespec))
if (rows (linespec) == columns (prompt) && columns (linespec) == 2)
## (rows x columns) match, copy array linespec
rowscols = linespec;
else
error ("inputdlg: ROWSCOLS matrix does not match size of PROMPT");
endif
else
## dunno
error ("inputdlg: unknown form of ROWSCOLS argument");
endif
rowscols = ceil (rowscols);
## convert numeric values in defaults cell array to strings
defs = cellfun (@num2str, defaults, "UniformOutput", false);
rc = arrayfun (@num2str, rowscols, "UniformOutput", false);
if (__octave_link_enabled__ ())
cstr = __octave_link_input_dialog__ (prompt, title, rowscols, defs);
elseif (__have_feature__ ("JAVA"))
user_inputs = javaMethod ("inputdlg", "org.octave.JDialogBox",
prompt, title, rc, defs);
if (isempty (user_inputs))
cstr = {};
else
cstr = cellstr (user_inputs);
endif
else
error ("inputdlg is not available in this version of Octave");
endif
endfunction
%!demo
%! disp ('- test inputdlg with prompt and caption only.');
%! prompt = {'Width','Height','Depth'};
%! dims = inputdlg (prompt, 'Enter Box Dimensions');
%! if (isempty (dims))
%! helpdlg ('Canceled by user', 'Information');
%! else
%! volume = str2num (dims{1}) * str2num (dims{2}) * str2num (dims{3});
%! surface = 2 * (str2num (dims{1}) * str2num (dims{2}) + ...
%! str2num (dims{2}) * str2num (dims{3}) + ...
%! str2num (dims{1}) * str2num (dims{3}));
%! helpdlg (sprintf ('Results:\nVolume = %.3f\nSurface = %.3f', volume, surface), 'Box Dimensions');
%! end
%!demo
%! disp ('- test inputdlg with prescribed scalar (2 lines per text field) and defaults.');
%! prompt = {'Width','Height','Depth'};
%! default = {'1.1','2.2','3.3'};
%! rc = 2;
%! dims = inputdlg (prompt, 'Enter Box Dimensions',rc,default);
%! if (isempty (dims))
%! helpdlg ('Canceled by user', 'Information');
%! else
%! volume = str2num (dims{1}) * str2num (dims{2}) * str2num (dims{3});
%! surface = 2 * (str2num (dims{1}) * str2num (dims{2}) + ...
%! str2num (dims{2}) * str2num (dims{3}) + ...
%! str2num (dims{1}) * str2num (dims{3}));
%! helpdlg (sprintf ('Results:\nVolume = %.3f\nSurface = %.3f', volume, surface), 'Box Dimensions');
%! end
%!demo
%! disp ('- test inputdlg with prescribed vector [1,2,3] for # of lines per text field and defaults.');
%! prompt = {'Width','Height','Depth'};
%! default = {'1.10', '2.10', '3.10'};
%! rc = [1,2,3]; % NOTE: must be an array
%! dims = inputdlg (prompt, 'Enter Box Dimensions',rc,default);
%! if (isempty (dims))
%! helpdlg ('Canceled by user', 'Information');
%! else
%! volume = str2num (dims{1}) * str2num (dims{2}) * str2num (dims{3});
%! surface = 2 * (str2num (dims{1}) * str2num (dims{2}) + ...
%! str2num (dims{2}) * str2num (dims{3}) + ...
%! str2num (dims{1}) * str2num (dims{3}));
%! helpdlg (sprintf ('Results:\nVolume = %.3f\nSurface = %.3f', volume, surface), 'Box Dimensions');
%! end
%!demo
%! disp ('- test inputdlg with prescribed row by column sizes and defaults.');
%! prompt = {'Width','Height','Depth'};
%! default = {'1.10', '2.20', '3.30'};
%! rc = [1,10; 2,20; 3,30]; % NOTE: must be an array
%! dims = inputdlg (prompt, 'Enter Box Dimensions',rc,default);
%! if (isempty (dims))
%! helpdlg ('Canceled by user', 'Information');
%! else
%! volume = str2num (dims{1}) * str2num (dims{2}) * str2num (dims{3});
%! surface = 2 * (str2num (dims{1}) * str2num (dims{2}) + ...
%! str2num (dims{2}) * str2num (dims{3}) + ...
%! str2num (dims{1}) * str2num (dims{3}));
%! helpdlg (sprintf ('Results:\nVolume = %.3f\nSurface = %.3f', volume, surface), 'Box Dimensions');
%! end
|
