view release on metacpan or  search on metacpan

lib/IUP/Dialog.pod  view on Meta::CPAN

bars in the main monitor. All dialog details, such as title bar,
borders, maximize button, etc, are removed. 

Possible values "YES", "NO".
In Motif you may have to click in the dialog to set its focus.

In Motif if set to YES when the dialog is hidden, then it can not be
changed after it is visible.

=item B<HWND>

I<[Windows Only] (non inheritable, read-only)> Returns the
Windows Window handle. Available in the Windows driver or in the GTK
driver in Windows.

=item B<MAXBOX>

I<(creation only)> Requires a maximize button from the window
manager. If RESIZE=NO then MAXBOX will be set to NO. Default: YES. In
Motif the decorations are controlled by the Window Manager and may not
be possible to be changed from IUP. In Windows MAXBOX is hidden only if
MINBOX is hidden as well, or else it will be just disabled.

=item B<MAXSIZE>

Maximum size for the dialog in raster units (pixels). The
windowing system will not be able to change the size beyond this limit.
Default: 65535x65535. 

=item B<MENU>

Name of a menu or L<IUP::Menu> reference. Associates a menu to the dialog as a menu bar.
The previous menu, if any, is unmapped.

=item B<MENUBOX>

I<(creation only)> Requires a system menu box from the window
manager. If hidden will also remove the Close button. Default: YES. In
Motif the decorations are controlled by the Window Manager and may not
be possible to be changed from IUP. In Windows if hidden will hide also
MAXBOX and MINBOX.

=item B<MINBOX>

I<(creation only)> Requires a minimize button from the window
manager. Default: YES. In Motif the decorations are controlled by the
Window Manager and may not be possible to be changed from IUP. In
Windows MINBOX is hidden only if MAXBOX is hidden as well, or else it
will be just disabled.

=item B<MINSIZE>

Minimum size for the dialog in raster units (pixels). The
windowing system will not be able to change the size beyond this limit.
Default: 1x1. Some systems define a very minimum size greatter than
this. Typically Windows has an horizontal minimum size that includes
the window decoration buttons. 

=item B<MODAL>

I<(read-only)> Returns the popup state. It is "YES" if the
dialog was shown using L<Popup|IUP::Manual::02_Elements/"Popup()">. It is "NO" if L<Show|IUP::Manual::02_Elements/"Show()"> was used
or it is not visible. 

=item B<NATIVEPARENT>

I<(creation only)> Native handle of a dialog to be used
as parent. Used only if PARENTDIALOG is not defined.

=item L<PARENTDIALOG|IUP::Manual::03_Attributes/PARENTDIALOG>

I<(creation only)> Name of a dialog to be used as parent.

=item B<PLACEMENT>

Changes how the dialog will be shown. Values:
"FULL", "MAXIMIZED", "MINIMIZED" and "NORMAL". Default: NORMAL. After
L<Show|IUP::Manual::02_Elements/"Show()">/L<Popup|IUP::Manual::02_Elements/"Popup()"> the attribute is set back to "NORMAL". FULL is
similar to FULLSCREEN but only the dialog client area covers the screen
area, menu and decorations will be there but out of the screen. In UNIX
there is a chance that the placement won't work correctly, that depends
on the Window Manager.

=item B<RESIZE>

I<(creation only)> Allows interactively changing the dialogs
size. Default: YES. If RESIZE=NO then MAXBOX will be set to NO. In
Motif the decorations are controlled by the Window Manager and may not
be possible to be changed from IUP.

=item B<SAVEUNDER>

I<[Windows and Motif Only] (creation only)> When this
attribute is true (YES), the dialog stores the original image of the
desktop region it occupies (if the system has enough memory to store
the image). In this case, when the dialog is closed or moved, a
redrawing event is not generated for the windows that were shadowed by
it. Its default value is YES. To save memory disable it for your main
dialog. Not available in GTK.

=item L<SHRINK|IUP::Manual::03_Attributes/SHRINK>

Allows changing the elements
distribution when the dialog is smaller than the minimum size. Default:
NO.

=item B<STARTFOCUS>

Name of the element that must receive the focus right
after the dialog is shown using L<Show|IUP::Manual::02_Elements/"Show()"> or L<Popup|IUP::Manual::02_Elements/"Popup()">. If not
defined then the first control than can receive the focus is selected
(same effect of calling L<NextField|IUP::Manual::02_Elements/"NextField()"> for
the dialog). Updated after SHOW_CB is called and only if the focus was
not changed during the callback.

=item B<XWINDOW>

I<[UNIX Only] (non inheritable, read-only)> Returns the
X-Windows Window (Drawable). Available in the Motif driver or in the
GTK driver in UNIX.