Navigation

Operators and Keywords

Function List:

• » Octave core
• » by package
• » alphabetical

C++ API

: h = dialog (…, "property", value, …)

Create an empty modal dialog window that other uicontrols can be added to.

The dialog box is a figure object with properties as recommended for a dialog box.

The default properties differing from a figure are:

buttondownfcn

if isempty(allchild(gcbf)), close(gcbf), end

colormap

[]

color

defaultuicontrolbackgroundcolor

dockcontrols

off

handlevisibility

callback

integerhandle

off

inverthardcopy

off

menubar

none

numbertitle

off

paperpositionmode

auto

resize

off

visible

on

windowstyle

modal

Multiple property-value pairs may be specified for the dialog object, but they must appear in pairs.

The return value h is a graphics handle to the created figure. object.

Examples:

% create an empty dialog window titled 'Dialog Example'
h = dialog ("name", "Dialog Example");

% create a button (default style)
b = uicontrol (h, "string", "OK", "position",[10 10 150 40], "callback","delete(gcf)");

% wait for dialog to resume or close
uiwait (h);

See also: figure, uiwait.

Package: octave