diff options
Diffstat (limited to 'Master/tlpkg/tlperl/lib/Tk/Widget.pod')
-rw-r--r-- | Master/tlpkg/tlperl/lib/Tk/Widget.pod | 678 |
1 files changed, 0 insertions, 678 deletions
diff --git a/Master/tlpkg/tlperl/lib/Tk/Widget.pod b/Master/tlpkg/tlperl/lib/Tk/Widget.pod deleted file mode 100644 index 696bbab22b7..00000000000 --- a/Master/tlpkg/tlperl/lib/Tk/Widget.pod +++ /dev/null @@ -1,678 +0,0 @@ -# Copyright (c) 1990-1994 The Regents of the University of California. -# Copyright (c) 1994-1997 Sun Microsystems, Inc. -# See the file "license.terms" for information on usage and redistribution -# of this file, and for a DISCLAIMER OF ALL WARRANTIES. -# -# - -=head1 NAME - -Tk::Widget - Base class of all widgets - -=for pm Tk/Widget.pm - -=for category Tk Generic Methods - -=head1 SYNOPSIS - - package Tk::Whatever; - require Tk::Widget; - @ISA = qw(Tk::Widget); - Construct Tk::Widget 'Whatever'; - - sub Tk_cmd { \&Tk::whatever } - -S< >I<$widget>-E<gt>I<method>(?I<arg, arg, ...>?) - -=head1 DESCRIPTION - -The B<Tk::Widget> is an abstract base class for all Tk widgets. - -Generic methods available to all widgets include the methods based on core -C<winfo> mechanism and are used to retrieve information about windows managed by -Tk. They can take any of a number of different forms, depending on the I<method>. -The legal forms are: - -=over 4 - -=item I<$widget>-E<gt>B<appname>?(I<newName>)? - -If I<newName> isn't specified, this method returns the name -of the application (the name that may be used in B<send> -commands to communicate with the application). -If I<newName> is specified, then the name of the application -is changed to I<newName>. -If the given name is already in use, then a suffix of the form -``B< #2>'' or ``B< #3>'' is appended in order to make the name unique. -The method's result is the name actually chosen. -I<newName> should not start with a capital letter. -This will interfere with L<option|Tk::option> processing, since names starting with -capitals are assumed to be classes; as a result, Tk may not -be able to find some options for the application. -If sends have been disabled by deleting the B<send> command, -this command will reenable them and recreate the B<send> -command. - -=item I<$widget>-E<gt>B<atom>(I<name>) - -Returns a decimal string giving the integer identifier for the -atom whose name is I<name>. If no atom exists with the name -I<name> then a new one is created. - -=item I<$widget>-E<gt>B<atomname>(I<id>) - -Returns the textual name for the atom whose integer identifier is -I<id>. -This command is the inverse of the I<$widget>-E<gt>B<atom> command. -It generates an error if no such atom exists. - -=item I<$widget>-E<gt>B<bell>( ?-nice? ); - -This command rings the bell on the display for I<$widget> and -returns an empty string. -The command uses the current bell-related settings for the display, which -may be modified with programs such as B<xset>. - -If I<-nice> is not specified, this command also resets the screen saver -for the screen. Some screen savers will ignore this, but others will -reset so that the screen becomes visible again. - -=item I<$widget>-E<gt>B<bindDump> - -This command returns a list of strings suitable for printing detailing -binding information for a widget. It prints a widget's -bindtags. For each binding tag it prints all the bindings, comprised -of the event descriptor and the callback. Callback arguments are -printed, and B<Tk::Ev> objects are expanded. - -=item I<$widget>-E<gt>B<Busy>?(?-recurse => 1?,I<-option> => I<value>?)? - -This method B<configure>s a B<-cursor> option for I<$widget> and -(if B<-recurse => 1> is specified) all its descendants. The cursor to -be set may be passed as S<B<-cursor> => I<cursor>> or defaults to 'watch'. -Additional B<configure> options are applied to I<$widget> only. -It also adds a special tag B<'Busy'> to the B<bindtags> of the widgets so -configured so that B<KeyPress>, B<KeyRelease>, B<ButtonPress> and -B<ButtonRelease> events are ignored (with press events generating a call to -B<bell>). It then acquires a local B<grab> for I<$widget>. -The state of the widgets and the grab is restored by a call to -I<$widget>-E<gt>B<Unbusy>. - -=item I<$widget>-E<gt>B<caret>( ?-x => I<x>?, ?-y => I<y>?, ?-height -=> I<height>? ); - -Sets and queries the caret location for the display of the specified -Tk window window. The caret is the per-display cursor location used -for indicating global focus (e.g. to comply with Microsoft -Accessibility guidelines), as well as for location of the -over-the-spot XIM (X Input Methods) or Windows IME windows. If no -options are specified, the last values used for setting the caret are -return in option-value pair format. -x and -y represent -window-relative coordinates, and -height is the height of the current -cursor location, or the height of the specified window if none is -given. - -=item I<$widget>-E<gt>B<cells> - -Returns a decimal string giving the number of cells in the -color map for I<$widget>. - -=item I<$widget>-E<gt>B<children> - -I<$widget->>B<children> -Returns a list containing all the children -of $widget. The list is in stacking order, with the lowest -window first. Top-level windows are returned as children -of their logical parents. - -=item I<$widget>-E<gt>B<class> - -Returns the class name for I<$widget>. - -=item I<$widget>-E<gt>B<colormapfull> - -Returns 1 if the colormap for I<$widget> is known to be full, 0 -otherwise. The colormap for a window is ``known'' to be full if the last -attempt to allocate a new color on that window failed and this -application hasn't freed any colors in the colormap since the -failed allocation. - -=item I<$widget>-E<gt>B<ConfigSpecs> - -Used to perform delegated option configuration for a mega-widget. -Returns, in Tk::Derived::ConfigSpecs notation (see L<Tk::ConfigSpecs>), -all possible options for a widget. For example, - - $s = $self->Scale; - $self->ConfigSpecs( - $s->ConfigSpecs, - .... more ConfigSpecs specifications - ); - -returns a hash of all Tk::Scale options, delegated to $s - e.g. some -representative examples: - - -bigincrement => [$s, bigIncrement, BigIncrement, 0, 0] - -digits => [$s, digits, Digits, 0, 0] - -sliderlength => [$s, sliderLength, SliderLength, 10m, 30] - -troughcolor => [$s, troughColor, Background, #c3c3c3, #c3c3c3] - -This provides an easy means of populating a mega-widget's ConfigSpecs -with initializers. - -=item I<$widget>-E<gt>B<containing>(I<rootX,rootY>) - -Returns the window containing the point given -by I<rootX> and I<rootY>. -I<RootX> and I<rootY> are specified in screen units (i.e. -any form acceptable to B<Tk_GetPixels>) in the coordinate -system of the root window (if a virtual-root window manager is in -use then the coordinate system of the virtual root window is used). -If no window in this application contains the point then an empty -string is returned. -In selecting the containing window, children are given higher priority -than parents and among siblings the highest one in the stacking order is -chosen. - -=item I<$widget>-E<gt>B<depth> - -Returns a decimal string giving the depth of I<$widget> (number -of bits per pixel). - -=item I<$widget>-E<gt>B<destroy> - -This command deletes the window related to -I<$widget>, plus all its descendants. -If all the B<MainWindows> are deleted then the entire application -will be destroyed. - -The perl object I<$widget> continues to exist while references -to it still exist, e.g. until variable goes out of scope. -However any attempt to use Tk methods on the object will fail. -B<Exists>(I<$widget>) will return false on such objects. - -Note however that while a window exists for I<$widget> the -perl object is maintained (due to "references" in perl/Tk internals) -even though original variables may have gone out of scope. -(Normally this is intuitive.) - -=item B<Exists>(I<$widget>) - -Returns 1 if there exists a window for I<$widget>, 0 if no such -window exists. - -=item I<$widget>-E<gt>B<font>(I<option>?, I<arg, arg, ...>?) - -Create and inspect fonts. See L<Tk::Font> for further details. - -=item I<$widget>-E<gt>B<fpixels>(I<number>) - -Returns a floating-point value giving the number of pixels -in I<$widget> corresponding to the distance given by I<number>. -I<Number> may be specified in any of the forms acceptable -to B<Tk_GetScreenMM>, such as ``2.0c'' or ``1i''. -The return value may be fractional; for an integer value, use -I<$widget>-E<gt>B<pixels>. - -=item I<$widget>-E<gt>B<Getimage>(I<name>) - -Given I<name>, look for an image file with that base name and return -a L<Tk::Image>. File extensions are tried in this order: F<xpm>, -F<gif>, F<ppm>, F<xbm> until a valid iamge is found. If no image is -found, try a builtin image with that name. - -=item I<$widget>-E<gt>B<geometry> - -Returns the geometry for I<$widget>, in the form -I<width>B<x>I<height>B<+>I<x>B<+>I<y>. All dimensions are -in pixels. - -=item I<$widget>-E<gt>B<height> - -Returns a decimal string giving I<$widget>'s height in pixels. -When a window is first created its height will be 1 pixel; the -height will eventually be changed by a geometry manager to fulfill -the window's needs. -If you need the true height immediately after creating a widget, -invoke B<update> to force the geometry manager to arrange it, -or use I<$widget>-E<gt>B<reqheight> to get the window's requested height -instead of its actual height. - -=item I<$widget>-E<gt>B<id> - -Returns a hexadecimal string giving a low-level platform-specific -identifier for $widget. On Unix platforms, this is the X -window identifier. Under Windows, this is the Windows -HWND. On the Macintosh the value has no meaning outside Tk. - -=item I<$widget>-E<gt>B<idletasks> - -One of two methods which are used to bring the application ``up to date'' -by entering the event loop repeated until all pending events -(including idle callbacks) have been processed. - -If the B<idletasks> method is specified, then no new events or errors -are processed; only idle callbacks are invoked. This causes operations -that are normally deferred, such as display updates and window layout -calculations, to be performed immediately. - -The B<idletasks> command is useful in scripts where changes have been -made to the application's state and you want those changes to appear -on the display immediately, rather than waiting for the script to -complete. Most display updates are performed as idle callbacks, so -B<idletasks> will cause them to run. However, there are some kinds of -updates that only happen in response to events, such as those -triggered by window size changes; these updates will not occur in -B<idletasks>. - -=item I<$widget>-E<gt>B<interps> - -Returns a list whose members are the names of all Tcl interpreters -(e.g. all Tk-based applications) currently registered for -a particular display. -The return value refers -to the display of I<$widget>. - -=item I<$widget>-E<gt>B<ismapped> - -Returns B<1> if I<$widget> is currently mapped, B<0> otherwise. - -=item I<$widget->>B<lower>(?I<belowThis>?) - -If the I<belowThis> argument is omitted then the command lowers -$widget so that it is below all of its siblings in the stacking -order (it will be obscured by any siblings that overlap it and -will not obscure any siblings). -If I<belowThis> is specified then it must be the path name of -a window that is either a sibling of $widget or the descendant -of a sibling of $widget. -In this case the B<lower> command will insert -$widget into the stacking order just below I<belowThis> -(or the ancestor of I<belowThis> that is a sibling of $widget); -this could end up either raising or lowering $widget. - -=item I<$widget>-E<gt>B<MapWindow> - -Cause I<$widget> to be "mapped" i.e. made visible on the display. -May confuse the geometry manager (pack, grid, place, ...) -that thinks it is managing the widget. - -=item I<$widget>-E<gt>B<manager> - -Returns the name of the geometry manager currently -responsible for I<$widget>, or an empty string if I<$widget> -isn't managed by any geometry manager. -The name is usually the name of the method for the geometry -manager, such as B<pack> or B<place>. -If the geometry manager is a widget, such as canvases or text, the -name is the widget's class command, such as B<canvas>. - -=item I<$widget>-E<gt>B<name> - -Returns I<$widget>'s name (i.e. its name within its parent, as opposed -to its full path name). -The command I<$mainwin>-E<gt>B<name> will return the name of the application. - -=item I<$widget>-E<gt>B<OnDestroy>(I<callback>); - -OnDestroy accepts a standard perl/Tk I<callback>. -When the window associated with I<$widget> is destroyed then -the callback is invoked. Unlike I<$widget->>bind('E<lt>DestroyE<gt>',...) -the widgets methods are still available when I<callback> is executed, -so (for example) a B<Text> widget can save its contents to a file. - -OnDestroy was required for new B<after> mechanism. - -=item I<$widget>-E<gt>B<parent> - -Returns I<$widget>'s parent, or an empty string -if I<$widget> is the main window of the application. - -=item I<$widget>-E<gt>B<PathName> - -Returns the Tk path name of I<$widget>. This is the inverse of the -L</Widget> method. (This is an import from the C interface.) - -=item I<$widget>-E<gt>B<pathname>(I<id>) - -Returns an object whose X identifier is I<id>. -The identifier is looked up on the display of I<$widget>. -I<Id> must be a decimal, hexadecimal, or octal integer and must -correspond to a window in the invoking application, or an error -occurs which can be trapped with C<eval { }> or C<Tk::catch { }>. -If the window belongs to the application, but is not an object -(for example wrapper windows, HList header, etc.) then C<undef> -is returned. - -=item I<$widget>-E<gt>B<pixels>(I<number>) - -Returns the number of pixels in I<$widget> corresponding -to the distance given by I<number>. -I<Number> may be specified in any of the forms acceptable -to B<Tk_GetPixels>, such as ``2.0c'' or ``1i''. -The result is rounded to the nearest integer value; for a -fractional result, use I<$widget>-E<gt>B<fpixels>. - -=item I<$widget>-E<gt>B<pointerx> - -If the mouse pointer is on the same screen as I<$widget>, returns the -pointer's x coordinate, measured in pixels in the screen's root window. -If a virtual root window is in use on the screen, the position is -measured in the virtual root. -If the mouse pointer isn't on the same screen as I<$widget> then --1 is returned. - -=item I<$widget>-E<gt>B<pointerxy> - -If the mouse pointer is on the same screen as I<$widget>, returns a list -with two elements, which are the pointer's x and y coordinates measured -in pixels in the screen's root window. -If a virtual root window is in use on the screen, the position -is computed in the virtual root. -If the mouse pointer isn't on the same screen as I<$widget> then -both of the returned coordinates are -1. - -=item I<$widget>-E<gt>B<pointery> - -If the mouse pointer is on the same screen as I<$widget>, returns the -pointer's y coordinate, measured in pixels in the screen's root window. -If a virtual root window is in use on the screen, the position -is computed in the virtual root. -If the mouse pointer isn't on the same screen as I<$widget> then --1 is returned. - -=item I<$widget>-E<gt>B<raise>(?I<aboveThis>?) - -If the I<aboveThis> argument is omitted then the command raises -$widget so that it is above all of its siblings in the stacking -order (it will not be obscured by any siblings and will obscure -any siblings that overlap it). -If I<aboveThis> is specified then it must be the path name of -a window that is either a sibling of $widget or the descendant -of a sibling of $widget. -In this case the B<raise> command will insert -$widget into the stacking order just above I<aboveThis> -(or the ancestor of I<aboveThis> that is a sibling of $widget); -this could end up either raising or lowering $widget. - -=item I<$widget>-E<gt>B<reqheight> - -Returns a decimal string giving I<$widget>'s requested height, -in pixels. This is the value used by I<$widget>'s geometry -manager to compute its geometry. - -=item I<$widget>-E<gt>B<reqwidth> - -Returns a decimal string giving I<$widget>'s requested width, -in pixels. This is the value used by I<$widget>'s geometry -manager to compute its geometry. - -=item I<$widget>-E<gt>B<rgb>(I<color>) - -Returns a list containing three decimal values, which are the -red, green, and blue intensities that correspond to I<color> in -the window given by I<$widget>. I<Color> -may be specified in any of the forms acceptable for a color -option. - -=item I<$widget>-E<gt>B<rootx> - -Returns a decimal string giving the x-coordinate, in the root -window of the screen, of the -upper-left corner of I<$widget>'s border (or I<$widget> if it -has no border). - -=item I<$widget>-E<gt>B<rooty> - -Returns a decimal string giving the y-coordinate, in the root -window of the screen, of the -upper-left corner of I<$widget>'s border (or I<$widget> if it -has no border). - -=item I<$widget>-E<gt>B<scaling>?(I<number>)? - -Sets and queries the current scaling factor used by Tk to convert between -physical units (for example, points, inches, or millimeters) and pixels. The -I<number> argument is a floating point number that specifies the number of -pixels per point on $widget's display. If the I<number> argument is -omitted, the current value of the scaling factor is returned. - -A ``point'' is a unit of measurement equal to 1/72 inch. A scaling factor -of 1.0 corresponds to 1 pixel per point, which is equivalent to a standard -72 dpi monitor. A scaling factor of 1.25 would mean 1.25 pixels per point, -which is the setting for a 90 dpi monitor; setting the scaling factor to -1.25 on a 72 dpi monitor would cause everything in the application to be -displayed 1.25 times as large as normal. The initial value for the scaling -factor is set when the application starts, based on properties of the -installed monitor (as reported via the window system), -but it can be changed at any time. Measurements made -after the scaling factor is changed will use the new scaling factor, but it -is undefined whether existing widgets will resize themselves dynamically to -accomodate the new scaling factor. - -=item I<$widget>-E<gt>B<screen> - -Returns the name of the screen associated with I<$widget>, in -the form I<displayName>.I<screenIndex>. - -=item I<$widget>-E<gt>B<screencells> - -Returns a decimal string giving the number of cells in the default -color map for I<$widget>'s screen. - -=item I<$widget>-E<gt>B<screendepth> - -Returns a decimal string giving the depth of the root window -of I<$widget>'s screen (number of bits per pixel). - -=item I<$widget>-E<gt>B<screenheight> - -Returns a decimal string giving the height of I<$widget>'s screen, -in pixels. - -=item I<$widget>-E<gt>B<screenmmheight> - -Returns a decimal string giving the height of I<$widget>'s screen, -in millimeters. - -=item I<$widget>-E<gt>B<screenmmwidth> - -Returns a decimal string giving the width of I<$widget>'s screen, -in millimeters. - -=item I<$widget>-E<gt>B<screenvisual> - -Returns one of the following strings to indicate the default visual -class for I<$widget>'s screen: B<directcolor>, B<grayscale>, -B<pseudocolor>, B<staticcolor>, B<staticgray>, or -B<truecolor>. - -=item I<$widget>-E<gt>B<screenwidth> - -Returns a decimal string giving the width of I<$widget>'s screen, -in pixels. - -=item I<$widget>-E<gt>B<server> - -Returns a string containing information about the server for -I<$widget>'s display. The exact format of this string may vary -from platform to platform. For X servers the string -has the form ``B<X>I<major>B<R>I<minor vendor vendorVersion>'' -where I<major> and I<minor> are the version and revision -numbers provided by the server (e.g., B<X11R5>), I<vendor> -is the name of the vendor for the server, and I<vendorRelease> -is an integer release number provided by the server. - -=item I<$widget>-E<gt>B<toplevel> - -Returns the reference of the top-level window containing I<$widget>. - -=item I<$widget>-E<gt>B<Unbusy> - -Restores widget state after a call to I<$widget>-E<gt>B<Busy>. - -=item I<$widget>-E<gt>B<UnmapWindow> - -Cause I<$widget> to be "unmapped" i.e. removed from the display. -This does for any widget what I<$widget>-E<gt>withdraw does for -toplevel widgets. May confuse the geometry manager (pack, grid, place, ...) -that thinks it is managing the widget. - -=item I<$widget>-E<gt>B<update> - -One of two methods which are used to bring the application ``up to date'' -by entering the event loop repeated until all pending events -(including idle callbacks) have been processed. - -The B<update> method is useful in scripts where you are performing a -long-running computation but you still want the application to respond -to events such as user interactions; if you occasionally call -B<update> then user input will be processed during the next call to -B<update>. - -=item I<$widget>-E<gt>B<useinputmethods>( ?I<boolean>? ) - -Sets and queries the state of whether Tk should use XIM (X Input -Methods) for filtering events. The resulting state is returned. -XIM is used in some locales (ie: Japanese, Korean), to handle -special input devices. This feature is only significant on X. -If XIM support is not available, this will always return 0. -If the boolean argument is omitted, the current state is -returned. This is turned on by default for the main display. - -=item I<$widget>-E<gt>B<viewable> - -Returns 1 if I<$widget> and all of its ancestors up through the -nearest toplevel window are mapped. Returns 0 if any of these -windows are not mapped. - -=item I<$widget>-E<gt>B<visual> - -Returns one of the following strings to indicate the visual -class for I<$widget>: B<directcolor>, B<grayscale>, -B<pseudocolor>, B<staticcolor>, B<staticgray>, or -B<truecolor>. - -=item I<$widget>-E<gt>B<visualid> - -Returns the X identifier for the visual for $widget. - -=item I<$widget>-E<gt>B<visualsavailable>(?B<includeids>?) - -Returns a list whose elements describe the visuals available for -I<$widget>'s screen. -Each element consists of a visual class followed by an integer depth. -The class has the same form as returned by I<$widget>-E<gt>B<visual>. -The depth gives the number of bits per pixel in the visual. -In addition, if the B<includeids> argument is provided, then the -depth is followed by the X identifier for the visual. - -=item I<$widget>-E<gt>B<vrootheight> - -Returns the height of the virtual root window associated with I<$widget> -if there is one; otherwise returns the height of I<$widget>'s screen. - -=item I<$widget>-E<gt>B<vrootwidth> - -Returns the width of the virtual root window associated with I<$widget> -if there is one; otherwise returns the width of I<$widget>'s screen. - -=item I<$widget>-E<gt>B<vrootx> - -Returns the x-offset of the virtual root window associated with I<$widget>, -relative to the root window of its screen. -This is normally either zero or negative. -Returns 0 if there is no virtual root window for I<$widget>. - -=item I<$widget>-E<gt>B<vrooty> - -Returns the y-offset of the virtual root window associated with I<$widget>, -relative to the root window of its screen. -This is normally either zero or negative. -Returns 0 if there is no virtual root window for I<$widget>. - -=item I<$widget->>B<waitVariable>(\$I<name>) - -=item I<$widget->>B<waitVisibility> - -=item I<$widget->>B<waitWindow> - -The B<tk wait> methods wait for one of several things to happen, -then it returns without taking any other actions. -The return value is always an empty string. -B<waitVariable> expects a reference to a perl -variable and the command waits for that variable to be modified. -This form is typically used to wait for a user to finish interacting -with a dialog which sets the variable as part (possibly final) -part of the interaction. -B<waitVisibility> waits for a change in I<$widget>'s -visibility state (as indicated by the arrival of a VisibilityNotify -event). This form is typically used to wait for a newly-created -window to appear on the screen before taking some action. -B<waitWindow> waits for I<$widget> to be destroyed. -This form is typically used to wait for a user to finish interacting -with a dialog box before using the result of that interaction. -Note that creating and destroying the window each time a dialog is required -makes code modular but imposes overhead which can be avoided by B<withdrawing> -the window instead and using B<waitVisibility>. - -While the B<tk wait> methods are waiting they processes events in -the normal fashion, so the application will continue to respond -to user interactions. -If an event handler invokes B<tkwait> again, the nested call -to B<tkwait> must complete before the outer call can complete. - -=item I<$widget>-E<gt>B<Walk>(I<proc>?, I<arg, ...>?) - -Traverse a widget hierarchy starting at I<$widget> while executing the -subroutine I<proc> to every visited widget. The arguments I<arg, ...> -are supplied to the subroutine. - -=item I<$widget>-E<gt>B<Widget>(I<pathname>) - -Returns the widget reference for the given Tk path name, or C<undef> -if the path name does not match a Tk widget. This is the inverse of -the L</PathName> method. (This is an import from the C interface.) - -=item I<$widget>-E<gt>B<width> - -Returns a decimal string giving I<$widget>'s width in pixels. -When a window is first created its width will be 1 pixel; the -width will eventually be changed by a geometry manager to fulfill -the window's needs. -If you need the true width immediately after creating a widget, -invoke B<update> to force the geometry manager to arrange it, -or use I<$widget>-E<gt>B<reqwidth> to get the window's requested width -instead of its actual width. - -=item I<$widget>-E<gt>B<windowingsystem> - -Returns the current Tk windowing system, one of B<x11> (X11-based), -B<win32> (MS Windows), B<classic> (Mac OS Classic), or B<aqua> (Mac OS X Aqua). - -=item I<$widget>-E<gt>B<x> - -Returns a decimal string giving the x-coordinate, in I<$widget>'s -parent, of the upper-left corner of I<$widget>'s border (or I<$widget> -if it has no border). - -=item I<$widget>-E<gt>B<y> - -Returns a decimal string giving the y-coordinate, in I<$widget>'s -parent, of the -upper-left corner of I<$widget>'s border (or I<$widget> if it -has no border). - -=back - -=head1 CAVEATS - -The above documentaion on generic methods is incomplete. - -=head1 KEYWORDS - -atom, children, class, geometry, height, identifier, information, interpreters, -mapped, parent, path name, screen, virtual root, width, window - -=cut - |