1 # Created by Octave 3.6.2, Sun Jul 22 21:28:07 2012 UTC <root@t61>
13 # name: <cell-element>
18 Install the java package.
19 Test the dlg... functions of the java package.
21 Author: Martin Hepperle
27 # name: <cell-element>
32 Install the java package.
36 # name: <cell-element>
43 # name: <cell-element>
47 -- Function file: P = errordlg (MESSAGE [,TITLE])
48 Displays the MESSAGE using an error dialog box. The TITLE can be
49 used optionally to decorate the dialog caption. The return value
53 See also: helpdlg, inputdlg, listdlg, questdlg, warndlg
58 # name: <cell-element>
62 Displays the MESSAGE using an error dialog box.
66 # name: <cell-element>
73 # name: <cell-element>
77 -- Function file: P = helpdlg (MESSAGE [,TITLE])
78 Displays a MESSAGE in a help dialog box. The help message can
79 have multiple lines, separated by a newline character '\n'. The
80 TITLE can be used optionally to decorate the dialog caption. The
81 return value is always 1.
84 See also: errordlg, inputdlg, listdlg, questdlg, warndlg
89 # name: <cell-element>
93 Displays a MESSAGE in a help dialog box.
97 # name: <cell-element>
104 # name: <cell-element>
108 -- Function file: P = inputdlg (PROMPT [,TITLE [,ROWSCOLS, DEFAULTS]])
109 Returns the user's inputs from a multi-textfield dialog box in
110 form of a cell array of strings. If the dialog is closed by the
111 Cancel button, an empty cell array is returned.
114 The first argument PROMPT is mandatory. It is a cell array
115 with strings labeling each textfield.
118 The optional string TITLE can be used as the caption of the
122 The size of the text fields can be defined by the argument
123 ROWSCOLS, which can have three forms: - a scalar value which
124 defines the number of rows used for each text field. - a
125 vector which defines the individual number of rows used for
126 each text field. - a matrix which defines the individual
127 number of rows and columns used for each text field.
130 It is possible to place default values into the text fields
131 by supplying the a cell array of strings or number for the
135 See also: errordlg, helpdlg, listdlg, questdlg, warndlg
140 # name: <cell-element>
144 Returns the user's inputs from a multi-textfield dialog box in form of
149 # name: <cell-element>
156 # name: <cell-element>
160 Please enter `doc java' to view the documentation for the package
166 # name: <cell-element>
170 Please enter `doc java' to view the documentation for the package
175 # name: <cell-element>
182 # name: <cell-element>
186 -- Function file: A = javaArray (CLASS,[M,N,...])
187 -- Function file: A = javaArray (CLASS,M,N,...)
188 Creates a Java array of size [M,N,...] with elements of class
189 CLASS. CLASS can be a Java object representing a class or a string
190 containing the fully qualified class name.
192 The generated array is uninitialized, all elements are set to null
193 if CLASS is a reference type, or to a default value (usually 0) if
194 CLASS is a primitive type.
196 a = javaArray ("java.lang.String", 2, 2);
203 # name: <cell-element>
207 Creates a Java array of size [M,N,.
211 # name: <cell-element>
218 # name: <cell-element>
222 -- Function file: javaaddpath (PATH)
223 Adds PATH to the dynamic class path of the Java virtual machine.
224 PATH can be either a directory where .class files can be found, or
225 a .jar file containing Java classes.
228 See also: javaclasspath
233 # name: <cell-element>
237 Adds PATH to the dynamic class path of the Java virtual machine.
241 # name: <cell-element>
248 # name: <cell-element>
252 -- Function file: javaclasspath
253 -- Function file: STATIC = javaclasspath
254 -- Function file: [STATIC, DYNAMIC] = javaclasspath
255 -- Function file: PATH = javaclasspath (WHAT)
256 Returns the class path of the Java virtual machine in the form of
257 a cell array of strings.
259 If called without input parameter:
260 * If no output variable is given, the result is simply printed
261 on the standard output.
263 * If one output variable STATIC is given, the result is the
266 * If two output variables STATIC and DYNAMIC are given, the
267 first variable will contain the static classpath, the second
268 will be filled with the dynamic claspath.
270 If called with a single input parameter WHAT:
271 * If WHAT is '-static' the static classpath is returned.
273 * If WHAT is '-dynamic' the dynamic classpath is returned.
275 * If WHAT is '-all' the static and the dynamic classpath are
276 returned in a single cell array
278 See also: javaaddpath, javarmpath
283 # name: <cell-element>
287 Returns the class path of the Java virtual machine in the form of a
292 # name: <cell-element>
299 # name: <cell-element>
303 -- Function file: P = javafields (CLASS)
304 Returns the fields of a Java object in the form of a cell array of
305 strings. If no output variable is given, the result is simply
306 printed on the standard output.
309 See also: javamethods
314 # name: <cell-element>
318 Returns the fields of a Java object in the form of a cell array of
323 # name: <cell-element>
330 # name: <cell-element>
334 -- Function File: javamem
335 -- Function File: [ JMEM] = javamem
336 Show current memory status of the Java virtual machine (JVM) & run
339 When no return argument is given the info is echoed to the screen.
340 Otherwise, output cell array JMEM contains Maximum, Total, and
341 Free memory (in bytes).
343 All Java-based routines are run in the JVM's shared memory pool, a
344 dedicated and separate part of memory claimed by the JVM from your
345 computer's total memory (which comprises physical RAM and virtual
346 memory / swap space on hard disk).
348 The maximum available memory can be set using the file java.opts
349 (in the same subdirectory where javaaddpath.m lives, see "which
350 javaaddpath". Usually that is:
351 [/usr]/share/octave/packages/java-<version>.
353 java.opts is a plain text file, one option per line. The default
354 initial memory size and default maximum memory size (which are
355 both system dependent) can be overridden like so:
358 (in megabytes in this example.) You can adapt these values to
359 your own requirements if your system has limited available
360 physical memory or when you get Java memory errors.
362 "Total memory" is what the operating system has currently assigned
363 to the JVM and depends on actual and active memory usage. "Free
364 memory" is self-explanatory. During operation of Java-based octave
365 functions the amounts of Total and Free memory will vary, due to
366 Java's own cleaning up and your operating system's memory
373 # name: <cell-element>
377 Show current memory status of the Java virtual machine (JVM) & run
382 # name: <cell-element>
389 # name: <cell-element>
393 -- Function file: P = javamethods (CLASS)
394 Returns the methods of a Java object in the form of a cell array
395 of strings. If no output variable is given, the result is simply
396 printed on the standard output.
404 # name: <cell-element>
408 Returns the methods of a Java object in the form of a cell array of
413 # name: <cell-element>
420 # name: <cell-element>
424 -- Function file: javarmpath (PATH)
425 Removes PATH from the dynamic class path of the Java virtual
426 machine. PATH can be either a directory where .class files can be
427 found, or a .jar file containing Java classes.
430 See also: javaaddpath, javaclasspath
435 # name: <cell-element>
439 Removes PATH from the dynamic class path of the Java virtual machine.
443 # name: <cell-element>
450 # name: <cell-element>
454 -- Function file: [SEL,OK] = listdlg (KEY ,VALUE [, KEY ,VALUE, ...]])
455 Returns the user's inputs from a list dialog box in form of a
456 vector of selection indices SEL and a flag OK indicating how the
457 user closed the dialog box. The returned flag OK is 1 if the user
458 closed the box with the OK button, otherwise it is 0 and SEL is
459 empty. The indices in SEL are 1 based, i.e. the first list item
462 The arguments are specified in form of KEY, VALUE pairs. At least
463 the 'ListString' argument pair must be specified.
465 KEYs and VALUEs pairs can be selected from the following list:
468 a cell array of strings comprising the content of the list.
471 can be either `Single' or `Multiple'.
474 a vector with two elements [width, height] defining the size
475 of the list field in pixels.
478 a vector containing 1-based indices of preselected elements.
481 a string to be used as the dialog caption.
484 a cell array of strings to be displayed above the list field.
487 a string used to label the OK button.
490 a string used to label the Cancel button.
494 [sel, ok] = listdlg ( 'ListString',{'An item', 'another', 'yet another'}, 'SelectionMode','Multiple' );
503 See also: errordlg, helpdlg, inputdlg, questdlg, warndlg
508 # name: <cell-element>
512 Returns the user's inputs from a list dialog box in form of a vector of
517 # name: <cell-element>
524 # name: <cell-element>
528 -- Function file: P = msgbox (MESSAGE [,TITLE [,ICON]])
529 Displays the MESSAGE using a message dialog. The TITLE is an
530 optional string, which can be used to decorate the dialog caption.
531 The ICON can be used optionally to select a dialog icon. It can
532 be one of `'error'', `'help'' or `'warn''. The return value is
536 See also: helpdlg, questdlg, warndlg
541 # name: <cell-element>
545 Displays the MESSAGE using a message dialog.
549 # name: <cell-element>
556 # name: <cell-element>
560 -- Function file: P = questdlg (MESSAGE, TITLE)
561 -- Function file: P = questdlg (MESSAGE, TITLE, DEFAULT)
562 -- Function file: P = questdlg (MESSAGE, TITLE, BTN1, BTN2, DEFAULT)
563 -- Function file: P = questdlg (MESSAGE, TITLE, BTN1, BTN2, BTN3,
565 Displays the MESSAGE using a question dialog box. The dialog
566 contains two or three buttons which all close the dialog. It
567 returns the caption of the activated button.
569 The TITLE can be used optionally to decorate the dialog caption.
570 The string DEFAULT identifies the default button, which is
571 activated by pressing the ENTER key. It must match one of the
572 strings given in BTN1, BTN2 or BTN3.
574 If only MESSAGE and TITLE are specified, three buttons with the
575 default captions "Yes", "No", "Cancel" are used.
577 If only two button captions BTN1 and BTN2 are specified, the
578 dialog will have only these two buttons.
581 See also: errordlg, helpdlg, inputdlg, listdlg, warndlg
586 # name: <cell-element>
590 Displays the MESSAGE using a question dialog box.
594 # name: <cell-element>
601 # name: <cell-element>
605 -- Function file: P = warndlg (MESSAGE [,TITLE])
606 Displays the MESSAGE using a warning dialog box. The TITLE can be
607 used optionally to decorate the dialog caption.
610 See also: helpdlg, inputdlg, listdlg, questiondlg
615 # name: <cell-element>
619 Displays the MESSAGE using a warning dialog box.