TopLevelWindow is a common base class for Dialog and
Frame. It is an abstract base class meaning that you never
work with objects of this class directly, but all of its methods are also
applicable for the two classes above.
Returns if the platform supports making the window translucent.
TopLevelWindow#set_transparent
Enables or disables the Close button (most often in the right
upper corner of a dialog) and the Close entry of the system
menu (most often in the left upper corner of the dialog).
Currently only implemented for MSW and GTK. Returns
true if operation was successful. This may be wrong on
X11 (including GTK+) where the window manager may not support
this operation and there is no way to find out.
Returns a pointer to the button which is the default for this window, or .
The default button is the one activated by pressing the Enter key.
Returns the standard icon of the window. The icon will be invalid if it hadn’t
been previously set by set_icon.
Returns all icons associated with the window, there will be none of them if
neither set_icon nor
set_icons had been called before.
Use get_icon to get the main icon of the
window.
Gets a string containing the window title.
Unique to the WinCE port. Responds to showing/hiding SIP (soft input panel) area and resize
window accordingly. Override this if you want to avoid resizing or do additional
operations.
Returns if this window is currently active, i.e. if the user is currently
working with it.
Returns if this window is expected to be always maximized, either due to platform policy
or due to local policy regarding particular class.
Iconizes or restores the window.
TopLevelWindow#is_iconized, TopLevelWindow#maximize.
Returns if the window is in fullscreen mode.
TopLevelWindow#show_full_screen
Returns if the window is iconized.
Returns if the window is maximized.
This method is specific to Universal port
Returns if this window is using native decorations, if we draw
them ourselves.
use_native_decorations_by_default
Maximizes or restores the window.
Use a system-dependent way to attract users attention to the window when it is
in background.
flags may have the value of either USER_ATTENTION_INFO
(default) or USER_ATTENTION_ERROR
which results in a more drastic
action. When in doubt, use the default value.
Note that this function should normally be only used when the application is
not already in foreground.
This function is currently implemented for Win32 where it flashes the
window icon in the taskbar, and for GTK with task bars supporting it.
Changes the default item for the panel, usually win is a button.
Sets the icon for this window.
The window takes a `copy’ of icon, but since it uses reference
counting, the copy is very quick. It is safe to delete icon after
calling this function.
See also Icon.
Sets several icons of different sizes for this window: this allows to use
different icons for different situations (e.g. task switching bar, taskbar,
window title bar) instead of scaling, with possibly bad looking results, the
only icon set by set_icon.
Sets action or menu activated by pressing left hardware button on the smart phones.
Unavailable on full keyboard machines.
TopLevelWindow#set_right_menu.
A simpler interface for setting the size hints than
set_size_hints.
A simpler interface for setting the size hints than
set_size_hints.
Allows specification of minimum and maximum window sizes, and window size increments.
If a pair of values is not set (or set to -1), the default values will be used.
If this function is called, the user will not be able to size the window outside
the given bounds. The resizing increments are only significant under Motif or Xt.
Sets action or menu activated by pressing right hardware button on the smart phones.
Unavailable on full keyboard machines.
If the platform supports it, sets the shape of the window to that
depicted by region. The system will not display or
respond to any mouse event for the pixels that lie outside of the
region. To reset the window to the normal rectangular shape simply
call SetShape again with an empty region. Returns true if the
operation is successful.
Sets the window title.
If the platform supports it will set the window to be translucent
Returns if the transparency was successfully changed.
This virtual function is not meant to be called directly but can be overridden
to return (it returns by default) to allow the application to
close even if this, presumably not very important, window is still opened.
By default, the application stays alive as long as there are any open top level
windows.
Depending on the value of show parameter the window is either shown full
screen or restored to its normal state. style is a bit list containing
some or all of the following values, which indicate what elements of the window
to hide in full-screen mode:
This function has not been tested with MDI frames.
Note that showing a window full screen also actually
show()s if it hadn’t been shown yet.
This method is specific to Universal port
Use native or custom-drawn decorations for this window only. Notice that to
have any effect this method must be called before really creating the window,
i.e. two step creation must be used:
use_native_decorations_by_default,
This method is specific to Universal port
Top level windows in Universal port can use either system-provided window
decorations (i.e. title bar and various icons, buttons and menus in it) or draw
the decorations themselves. By default the system decorations are used if they
are available, but this method can be called with native set to to
change this for all windows created after this point.
Also note that if WXDECOR
environment variable is set, then custom
decorations are used by default and so it may make sense to call this method
with default argument if the application can’t use custom decorations at all
for some reason.
[This page automatically generated from the Textile source at 2023-06-13 21:31:30 +0000]