view release on metacpan or  search on metacpan

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

=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.

=back

=head2 Exclusive [Windows and GTK Only]

=over

=item B<ACTIVEWINDOW>

I<[Windows and GTK Only] (read-only)> informs if the
dialog is the active window (the window with focus). Can be Yes or No.
(since iup-3.4)

=item B<HIDETASKBAR>

I<[Windows and GTK Only] (write-only)> Action attribute
that when set to "YES", hides the dialog, but does not decrement the
visible dialog count, does not call SHOW_CB and does not mark the
dialog as hidden inside IUP. It is usually used to hide the dialog and
keep the tray icon working without closing the main loop. It has the
same effect as setting LOCKLOOP=Yes and normally hiding the dialog.
IMPORTANT: when you hide using HIDETASKBAR, you must show using
HIDETASKBAR also. Possible values: YES, NO.

=item B<OPACITY>

I<[Windows and GTK Only]> sets the dialog transparency alpha
value. Valid values range from 0 (completely transparent) to 255
(opaque). In Windows set to C<undef> to remove the LAYERED style bit. (GTK
2.12)

=item B<TOPMOST>

I<[Windows and GTK Only]> puts the dialog always in front of
all other dialogs in all applications. Default: NO.