FreeBSD Manual Pages
XmtLayout(3) Library Functions Manual XmtLayout(3) NAME XmtLayout - a general-purpose manager widget. SYNOPSIS Include File: #include <Xmt/Layout.h> Constructor: XmtCreateLayout() Class Name: XmtLayout Class Pointer: xmtLayoutWidgetClass Class Hierarchy: Core -> Composite -> Constraint -> XmManager -> XmBulletinBoard -> XmtLayout DESCRIPTION The XmtLayout widget is a general-purpose manager widget. It uses con- straint resources to provide a dynamic interface for positioning children, and also parses a simple layout grammar which describes the widget layout with a single string resource. Children of the Layout widget are laid out in nested rows and columns, with specified amounts of blank space between them. All children (including rows and columns), and the space between the children have a ``stretchiness'' factor that specifies how much each child or space will grow when the wid- get is resized. This is a fully general layout scheme, derived from the TeX ``boxes-and-glue'' text layout algorithm. It is as powerful and flexible as the ``attachment'' scheme used by the XmForm widget, for example, but eas- ier to understand, and through the layout grammar, far easier to specify. The Layout widget provides some features beyond simple layout of widgets. It will draw a frame around any of its children, will draw a separator run- ning along any edge of any child, and can also display a text caption for each of its children. Since the Layout widget does this drawing itself, the overhead of the XmFrame, XmSeparator, and XmLabel widgets that would other- wise be needed is avoided. The Layout widget also supports special gadget children that display text and pixmap labels. These gadgets are cheaper than widgets, and are even cheaper than the Motif XmGadget types. Finally, the Layout widget allows the sizes of its children to be specified in resolution-independent units. The static layout grammar allows sizes to be directly specified in inches, millimeters, points, ems or ens, and a public function exists to convert from these units to pixels for dynamic layouts. RESOURCES Layout inherits the resources of the XmBulletinBoard class, and defines or overrides the following resources: +--------------------+------------------------+--------------------+--------+----------------+ | Name | Type | Class | Access | Default | +--------------------+------------------------+--------------------+--------+----------------+ | XmtNdebugLayout | XtRBoolean | XmtCDebugLayout | CSG | False | +--------------------+------------------------+--------------------+--------+----------------+ | XmtNdefaultSpacing | XtRDimension | XmtCDefaultSpacing | CSG | 10 | +--------------------+------------------------+--------------------+--------+----------------+ | XmtNfont | XtRFontStruct | XtCFont | CSG | XtDefaultFont | +--------------------+------------------------+--------------------+--------+----------------+ | XmtNfontList | XmRFontList | XmCFontList | CSG | NULL | +--------------------+------------------------+--------------------+--------+----------------+ | XmtNlayout | XtRString | XmtCLayout | C | NULL | +--------------------+------------------------+--------------------+--------+----------------+ | XmNmarginHeight | XmRVerticalDimension | XmCMarginHeight | CSG | 5 | +--------------------+------------------------+--------------------+--------+----------------+ | XmNmarginWidth | XmRHorizontalDimension | XmCMarginWidth | CSG | 5 | +--------------------+------------------------+--------------------+--------+----------------+ | XmtNorientation | XmROrientation | XmCOrientation | CG | XmVERTICAL | +--------------------+------------------------+--------------------+--------+----------------+ XmtNdebugLayout If True, the Layout widget will draw a one pixel wide frame around each of its children, including spaces, rows and columns. This makes it easy to see which nested row or column each child is positioned in, and can help when debugging layouts. When this resource is set, XmtNlayoutFrameType and the other frame constraint resources, de- scribed below, are ignored. XmtNdefaultSpacing The width or height, in pixels, of the fixed-size, nonstretchable space specified in the layout grammar with the `#' character. This value is not directly used by the Layout widget or the XmtLayout- Space gadget. XmtNfont An XFontStruct pointer used to set the XmtNfontList resource if it is left unspecified. This resource is provided because it is some- times more convenient to specify an Xlib XFontStruct than a Motif XmFontList. XmtNfontList The XmFontList that is be used by all XmtLayoutString gadget chil- dren and may also be used other XmtLayout Gadget children that draw text. If this resource is unspecified, the XmtNfont resource will be used to create an XmFontList instead. XmtNlayout A string that specifies a static layout for the children of the Lay- out widget. In order for this resource to work, the application pro- grammer must register the layout grammar parser by calling XmtRegis- terLayoutParser(). See the ``Layout Grammar'' section below for more information. This resource should be set when the Layout widget is created, and may never be changed. The Layout widget parses this string once, without modifying it, and never refers to it again. For this reason, the widget does not make a copy of the string, which means that this resource should not be queried. XmNmarginHeight The height, in pixels of the margin between the top and bottom edges of the widget and the nearest child. This is an XmBulletinBoard re- source; the Layout widget over rides the default value to 5 pixels. XmNmarginWidth The width, in pixels of the margin between the left and right edges of the widget and the nearest child. This is an XmBulletinBoard re- source; the Layout widget over rides the default value to 5 pixels. XmtNorientation The orientation of the topmost (automatically created) row or column of the Layout widget. Children widgets that are not explicitly posi- tioned in a row or column with constraint resources will be placed in this toplevel row or column. Legal values are XmVERTICAL and XmHORIZONTAL. XmVERTICAL is the default, so that the Layout widget arranges its children in a column. This resource may be set when the Layout widget is created, but may never be changed. Constraint RESOURCES The Layout widget specifies the layout and decoration of its children through constraint resources. Each of the constraint re- source names begins with the prefix ``layout'' in order to avoid name clashes with the resources of the child widgets to which these constraints are applied. The Layout constraint resources are the following: +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | Name | Type | Class | Access | Default | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutAfter | XtRWidget | XmtCLayoutAfter | CSG | NULL | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutAllowResize | XtRBoolean | XmtCLayoutAllowResize | CSG | True | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutBefore | XtRWidget | XmtCLayoutBefore | CSG | NULL | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutCaption | XmRXmString | XmtCLayoutCaption | CSG | NULL | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutCaptionAlignment | XmRAlignment | XmtCLayoutCaptionAlignment | CSG | XmALIGNMENT_BEGINNING | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutCaptionJustification | XmtRXmtLayout | XmtCLayoutCaptionJustification | CSG | XmtLayoutCentered | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutCaptionMargin | XtRDimension | XmtCLayoutCaptionMargin | CSG | 2 | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutCaptionPosition | XmtRXmtLayoutEdge | XmtCLayoutCaptionPosition | CSG | XmtLayoutLeft | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutFrameLineType | XmtRXmtLayoutFrameLineType | XmtCLayoutFrameLineType | CSG | XmtLayoutFrameEtchedIn | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutFrameMargin | XtRDimension | XmtCLayoutFrameMargin | CSG | 5 | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutFramePosition | XmtRXmtLayoutFramePosition | XmtCLayoutFramePosition | CSG | XmtLayoutFrameInside | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutFrameThickness | XtRDimension | XmtCLayoutFrameThickness | CSG | 2 | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutFrameType | XmRXmtLayoutFrameType | XmtCLayoutFrameType | CSG | XmtLayoutFrameNone | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutHeight | XtRDimension | XmtCLayoutHeight | CSG | 0 | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutIn | XtRWidget | XmtCLayoutIn | CSG | NULL | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutJustification | XmtRXmtLayoutJustification | XmtCLayoutJustification | CSG | XmtLayoutFilled | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutMarginHeight | XtRDimension | XmtCLayoutMarginHeight | CSG | see below | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutMarginWidth | XtRDimension | XmtCLayoutMarginWidth | CSG | see below | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutPosition | XtRPosition | XmtCLayoutPosition | CSG | -1 | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutSensitive | XtRBoolean | XmtCLayoutSensitive | CSG | True | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutShrinkability | XtRDimension | XmtCLayoutShrinkability | CSG | see below | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutStretchability | XtRDimension | XmtCLayoutStretchability | CSG | see below | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ | XmtNlayoutWidth | XtRDimension | XmtCLayoutWidth | CSG | 0 | +--------------------------------+----------------------------+--------------------------------+--------+------------------------+ XmtNlayoutAfter The widget directly after which, in the same row or column, this child should be laid out. Setting this resource positions the child in the Layout widget and causes the XmtNlayoutBefore, XmtNlayout In, and XmtNlayoutPosition constraint resources to be updated to reflect the new position. If this resource is set, it overrides those other position resources. XmtNlayoutAllowResize Whether the Layout widget will attempt to grant resize requests from children. If False, any geometry request from this child will be re- fused. The default is True. XmtNlayoutBefore The widget directly before which, in the same row or column, this child should be laid out. Setting this resource positions the child in the Layout widget and causes the XmtNlayoutAfter, XmtNlayoutIn, and XmtNlayoutPosition constraint resources to be updated to reflect the new position. The XmtNlayoutAfter resource overrides this re- source, if it is set, and this resource overrides the XmtNlayoutIn and XmtNlayoutPosition resources. XmtNlayoutCaption An XmString to be displayed by the Layout widget as a caption for this child. This string is drawn entirely by the Layout widget with- out the need for an XmLabel or any other widget or gadget. XmtNlayoutCaptionAlignment The alignment of lines within a multi-line caption. This resource is of the same type as the XmNalignment resource of the XmLabel wid- get and has three legal values: XmALIGNMENT_BEGINNING which draws the lines flush left with the bounding box of the whole string, XmA- LIGNMENT_CENTER, which centers the individual lines within the box, and XmALIGNMENT_END which draws the lines flush right. This re- source only has effect when the caption has more than one line; it controls the positioning of individual lines relative to the caption as a whole. Do not confuse it with the XmtNlayoutCaptionJustifica- tion resource which controls the positioning of the entire caption relative to the widget. XmtNlayoutCaptionJustification The justification of the caption along the edge specified by the XmtNlayoutCaptionPosition resource. For captions placed along the left or right edges of the widget, this resource controls the verti- cal justification of the caption, and for captions placed along the top or bottom edges, it controls the horizontal justification. The values XmtLayoutFlushLeft and XmtLayoutFlushTop are equivalent and both produce left or top justification depending upon the XmtNlay- outCaptionPosition resource. The value XmtLayoutCentered centers the caption vertically or horizontally, and the values XmtLayout- FlushRight and XmtLayoutFlushBottom produce right or bottom justifi- cation. XmtNlayoutCaptionMargin The distance, in pixels, between the closest edge of the caption and the child widget, or between the caption and the frame surrounding the child widget. To save space in the Layout constraint record, this resource is stored in a unsigned character field, and therefore has a maximum value of 255 pixels. XmtNlayoutCaptionPosition The edge of the child widget along which the caption should be dis- played. Legal values are XmtLayoutLeft, XmtLayoutRight, XmtLayout- Top, and XmtLayoutBottom. XmtNlayoutFrameLineType The style of line to be used for the frame. The values XmtLayout- FrameShadowIn, XmtLayoutFrameShadowOut, XmtLayoutFrameEtchedIn, and XmtLayoutFrameEtchedOut draw the standard shadowed and etched frames supported by the XmFrame widget. XmtLayoutFrameSingleLine draws a single line in the foreground color, with its width specified by the XmtNlayoutFrameThickness constraint. XmtLayoutFrameDoubleLine draws two single-pixel wide lines, with a separation determined by the XmtNlayoutFrameThickness constraint. When the XmtNlayoutFrameType resource specifies that the frame should be drawn as a separator along only one edge of the widget, the ``shadow in'' and ``shadow out'' types are drawn as ``etched in'' and ``etched out''. XmtNlayoutFrameMargin The distance, in pixels, between the inside of the frame and the child widget, or the frame and the caption, if a caption is speci- fied and appears within the frame. For efficiency, this resource is stored in an unsigned character field of the Layout constraint record. This means that the maximum value of this resource is 255. XmtNlayoutFramePosition How the frame should be positioned with respect to the caption, if any, of the child. The value XmtLayoutFrameInside specifies that the frame should be drawn inside of the caption. In this case, the posi- tion of the caption may be adjusted, depending on its justification, so that it is flush with an outside edge of the frame rather than an edge of the child widget itself. The value XmtLayoutFrameOutside specifies that the frame should surround both the child widget and its caption. The value XmtLayoutFrameThrough specifies that the frame and caption should be drawn independently at the distances from the child specified by the XmtNlayout FrameMargin and XmtNlay- outCaptionMargin constraints. By default, this will cause the cap- tion to be drawn over a portion of the frame, which produces an ap- pealing visual effect with some line types. XmtNlayoutFrameThickness The line thickness of the frame to be drawn. This resource is stored in an unsigned character field of the Layout constraint record. This means that the maximum value for this resource is 255. XmtNlayoutFrameType The type of frame to be drawn. The default value, XmtLayoutFrameNone specifies that no frame is to be drawn. XmtLayoutFrameBox specifies that a traditional frame is to be drawn as a box around the child. The remaining legal values for this resource, XmtLayoutFrameLeft, XmtLayoutFrameRight, XmtLayoutFrameTop, and XmtLayoutFrameBottom, specify that the frame is to be drawn only along one edge of the widget. In this case, the frame serves as a separator, like those drawn by the Motif XmSeparator widget. XmtNlayoutHeight The preferred height, in pixels, of this child. If specified, this is the initial height of the child, and is the base height from which the child will stretch or shrink. If set to 0, the child's preferred height will be used. Note that this size does not include any space required for the child's margins, caption, or frame. XmtNlayoutIn The row or column gadget within which this child should be laid out. Setting this constraint resource, in conjunction with XmtNlayoutPo- sition resource, positions the child in the Layout widget and causes the XmtNlayoutAfter and XmtNlayoutBefore resources to be set to re- flect the position. The XmtNlayoutAfter and XmtNlayoutBefore re- sources override this resource, if either is set. If none of these resources are set, then the child will be positioned in the topmost row or column. The orientation of this topmost box is determined by the Layout XmtNorientation resource. XmtNlayoutJustification The justification of this child within the width of its column, or within the height of its row. This resource is of type XmtLayoutJus- tification which is an enumerated type with the following legal val- ues: XmtLayoutFilled, XmtLayoutCentered, XmtLayoutFlushLeft, XmtLay- outFlushTop, XmtLayoutFlushRight, and XmtLayoutFlushBottom. The de- fault is XmtLayoutFilled which specifies that the child should be as wide as its containing column or as high as its containing row. The other values indicate that the child should be laid out at its nat- ural size against the left, top, right, or bottom edges of the con- taining row or column, or centered within its containing row or col- umn. Note that this resource only positions child widgets within the ``minor dimension'' of a row or column-vertically in a row and hori- zontally in a column. XmtNlayoutMarginHeight The height, in pixels, of a margin to be placed above and below the child widget. This margin falls outside of any caption or frame that the child might have. For memory efficiency, this resource is stored in an unsigned character field, and therefore has a maximum value of 255. The default margin for most children is one-half of the space size specified by the XmtNdefaultSpacing resource of the Layout wid- get itself, but the default margin for rows and columns is 0, so that children positioned within nested rows and columns do not be- come nested within multiple margins. XmtNlayoutMarginWidth The width, in pixels, of a margin to be placed to the left and to the right of the child widget. This margin falls outside of any caption or frame that the child might have. For memory efficiency, this resource is stored in an unsigned character field, and there- fore has a maximum value of 255. The default margin for most chil- dren is one-half of the space size specified by the XmtNdefaultSpac- ing resource of the Layout widget itself, but the default margin for rows and columns is 0, so that children positioned within nested rows and columns do not become nested within multiple margins. XmtNlayoutPosition The numerical position within the containing row or column at which this child should be laid out. Setting this constraint resource, in conjunction with XmtNlayoutIn resource, positions the child in the Layout widget and causes the XmtNlayoutAfter and XmtNlayoutBefore resources to be set to reflect that position. The XmtNlayoutAfter and XmtNlayoutBefore resources override this resource, if either is set. The position 0 specifies that the child is to be the first in the row or column, and the special value -1 (the default) specifies that it is to be the last. The defaults for the positioning con- straint resources are chosen so that children will be positioned by default at the end of the topmost (automatically created) row or column. XmtNlayoutSensitive Specifies whether the child is sensitive or not. If False, the child's caption, if any, will be drawn ``greyed out'' with a stip- ple. Generally, if a child has a caption, this constraint resource should be set whenever a widget's XtNsensitive resource is set ei- ther directly or with XtSetSensitive(). The XmtChooser and XmtIn- putField wid gets are often used with a caption, and automatically set this resource whenever their XtNsensitive resource changes. XmtNlayoutShrinkability The ``shrinkability factor'' for this child, which controls whether, and in what proportion to other children, this child will shrink when the parent Layout widget is made smaller than its default size. The default value is 10 for all widgets, XmGadgets, rows, columns, and XmtLayoutSpace gadgets. For Layout string, pixmap, and separa- tor gadgets, the default is 0. XmtNlayoutStretchability The ``stretchability factor'' for this child, which controls whether, and in what proportion to other children, this child will stretch when the parent Layout widget is made larger than its de- fault size. The default value is 10 for all widgets, XmGadgets, rows, columns, and XmtLayoutSpace gadgets. For Layout string, pixmap, and separator gadgets, the default is 0. XmtNlayoutWidth The preferred width, in pixels, of this child. If specified, this is the initial width of the child, and the base width from which the child will stretch or shrink. If unspecified, the child's preferred width will be used. Note that this size does not include any space required for the child's margins, caption, or frame. Row and Column Resources The Layout widget arranges its children into nested rows and columns. These rows and columns are themselves children of the Layout widget, implemented as a special gadget type, the XmtLayoutBox. The Layout widget and the Xmt- LayoutBox gadget work together closely, and much of the important layout functionality of the Layout widget is in fact implemented by the XmtLayout- Box. Because the XmtLayoutBox is so important to the layout process, its resources are summarized here. You can find a more complete listing in the XmtLayoutBox reference page. +------------------+------------------------+------------------+--------+--------------------+ | Name | Type | Class | Access | Default | +------------------+------------------------+------------------+--------+--------------------+ | XmtNbackground | XtRPixel | XtCBackground | CSG | unspecified | +------------------+------------------------+------------------+--------+--------------------+ | XmtNequal | XtRBoolean | XmtCEqual | CSG | (XtPointer)False | +------------------+------------------------+------------------+--------+--------------------+ | XmtNitemStretch | XtRDimension | XmtCItemStretch | CSG | 1 | +------------------+------------------------+------------------+--------+--------------------+ | XmtNorientation | XmROrientation | XmCOrientation | CSG | XmHORIZONTAL | +------------------+------------------------+------------------+--------+--------------------+ | XmtNspace | XtRDimension | XmtCSpace | CSG | 0 | +------------------+------------------------+------------------+--------+--------------------+ | XmtNspaceStretch | XtRDimension | XmtCSpaceStretch | CSG | 1 | +------------------+------------------------+------------------+--------+--------------------+ | XmtNspaceType | XmtRXmtLayoutSpaceType | XmtCSpaceType | CSG | XmtLayoutSpaceNone | +------------------+------------------------+------------------+--------+--------------------+ Layout Grammar The XmtNlayout resource is a string which specifies the layout of the Wid- get and XmGadget children of the XmtLayout widget, and may also specify XmtLayoutGadget children to be automatically created. The string is a list of items that appear in the toplevel row or column (its orientation is de- termined by the XmtNorientation resource). These items may include nested rows or columns which have a list of their own items within curly braces. Any item may have a list of modifiers which specify size, stretchability, justification, captions, frames, and so on. Rows, columns, and other layout gadgets are automatically created as the layout specification is parsed. Widgets and XmGadget items can be specified by name in the layout string. When an item name is encountered without any type, it is assumed to be a widget or gadget that will be created later. The XmtLayout widget remembers the position and modifiers specified for this widget, and applies them when a widget by that name is eventually cre- ated. The XmtLayout widget does not link the parser for this layout grammar by default. If you specify a value for the XmtNlayout resource, you should also register the parser by calling XmtRegisterLayoutParser(). If an appli- cation never calls this function, that code will never be linked. This means that statically linked applications that do not use the parser do not pay the overhead of the parser code. The layout grammar was designed to be easily readable and intuitive. Chap- ter 18, The Layout Widget: A Tutorial, provides an extended tutorial on us- ing the grammar, and Chapter 19, The Layout Widget: The Details, contains an annotated definition of the grammar that explains the semantics as well as the syntax. For reference, the layout grammar is summarized in BNF form below. Items within single quotes are terminal symbols of the grammar-keywords or punc- tuation that should appear exactly as shown. Items in italics are non- terminals-items that are defined elsewhere in the grammar, or which are im- plicitly defined. Items within curly braces are repeated zero or more times and items within square brackets are optional. When a non-terminal has more than one possible definition, they are presented on separate lines, or are separated by vertical bars. Note that the grammar is case-sensitive and that almost all keywords begin with a capital letter. This means that keywords will not conflict with wid- get names which, by convention, begin with a lowercase letter. layout:: { { modifier } item } item:: widget | box | label | icon | separator | space widget:: identifier registered-widget-type identifier box:: `Row' [ name ] `{' layout `}' `Col' [ name ] `{' layout `}' label::string `String' [ name ] string icon:: `Pixmap' [ name ] pixmap-name [ `,' mask name ] `Bitmap' [ name ] bitmap-name [ `,' mask name ] separator:: `VSep' | `|' `HSep' | `=' space::`Space' | `#'{`#'} | `~'{`~'} | `<>' |modifier:: caption | frame | spacing | justification | size | resize | margin | misc caption:: `Caption' [edge[just[align]]] [ margin ] string edge:: `l' | `r' | `t' | `b' just:: `l' | `r' | `t' | `b' | `c' align::`l' | `r' | `c' margin:: integer frame:: `Etched[`In'] [edge ] [ position ] [ margin [ thickness ]] `Etched Out' [edge ] [ position ] [ margin [ thickness ]] `Shadowed'[`In'] [edge ] [ position ] [ margin [ thickness ]] `Shadowed Out' [edge ] [ position ] [ margin [ thickness ]] `Boxed' [edge ] [ position ] [ margin [ thickness ]] `DoubleBoxed' [edge ] [ position ] [ margin [ thickness ]] `DoubleLine' [edge ] [ position ] [ margin [ thickness ]] edge:: `Left' | `Right' | `Top' | `Bottom' position:: `Inside' | `Outside' | `Through' margin:: integer thickness:: integer spacing:: `Equal' `Even' [ space ] [ `+' space_stretch [ `/' item_stretch ] ] `EvenSpaced' [ space ] [ `+' space_stretch [ `/' item_stretch ] ] `LREvenSpaced' [ `+' space_stretch [ `/' item_stretch ] ] `LCRSpaced' [ space ] [ `+' space_stretch [ `/' item_stretch ] ] `IntervalSpaced' [ `+' space_stretch [ `/' item_stretch ] ] space::integer-or-float [ units ] space_stretch:: integer item_stretch:: integer justification:: |`Filled' | `FlushLeft' | `FlushTop' | `FlushRight' | `Flush- Bottom' | `Centered' size:: integer-or-float [ units ] integer-or-float [ units ] `Wide' integer-or-float [ units ] `High' integer-or-float [ units ] `%' integer-or-float [ units ] resize:: `Fixed' | `Stretchable' `+' integer `-' integer margin:: `Margin' integer `Margin Width' integer `Margin Height' integer misc:: `Color' string `Unresizable' `Unmanaged' name:: identifier units::`in' | `mm' | `pt' | `em' | `en' TRANSLATIONS and ACTIONS The Layout widget inherits the translations of the Xm BulletinBoard class which serve mainly to allow traversal to work for XmGadget children of the widget. The Layout widget does not define any new translations, nor any new actions. CALLBACKS The Layout widget does not define any new callback resources. Types A number of the Layout widget and XmtLayoutBox gadget resources and con- straint resources use enumerated types. These types are defined as follows in the header file <Xmt/Layout.h>. typedef enum { XmtLayoutFilled, XmtLayoutFlushLeft, XmtLayoutFlushTop, XmtLayoutFlushRight, XmtLayoutFlushBottom, XmtLayoutCentered } XmtLayoutJustification; typedef enum { XmtLayoutTop, XmtLayoutBottom, XmtLayoutLeft, XmtLayoutRight } XmtLayoutEdge; typedef enum { XmtLayoutFrameNone, XmtLayoutFrameBox, XmtLayoutFrameLeft, XmtLayoutFrameRight, XmtLayoutFrameTop, XmtLayoutFrameBottom } XmtLayoutFrameType; typedef enum { XmtLayoutFrameShadowIn, XmtLayoutFrameShadowOut, XmtLayoutFrameEtchedIn, XmtLayoutFrameEtchedOut, XmtLayoutFrameSingleLine, XmtLayoutFrameDoubleLine, } XmtLayoutFrameLineType; typedef enum { XmtLayoutFrameInside, XmtLayoutFrameThrough, XmtLayoutFrameOutside } XmtLayoutFramePosition; typedef enum { XmtLayoutSpaceNone, XmtLayoutSpaceEven, XmtLayoutSpaceLREven, XmtLayoutSpaceInterval, XmtLayoutSpaceLCR } XmtLayoutSpaceType; Converters The Layout widget registers type converters for all of the enumerated types it uses: XmtLayoutJustification, XmtLayoutEdge, XmtLayoutFrame- LineType, XmtLayoutFrameType, XmtLayoutFramePosition, and XmtLayout- SpaceType. The converters are all case-sensitive; the value must ap- pear in a resource file as it would in a C file, except that any of the repeated prefixes may be omitted. Thus the following strings can all be converted to the value XmtLayoutFrame EtchedIn: ``XmtLayout- FrameEtchedIn'', ``LayoutFrameEtchedIn'', ``FrameEtchedIn'', and ``EtchedIn''. See the ``Types'' section above for a complete list of enumerated types and values used by the Layout widget. The XmtNlayout resource is of type XtRString, so the layout grammar specified on this resource does not need a resource converter to con- vert it into some internal type. Instead, the Layout widget parses this string to create the layout. This ``layout parser'' is similar to a resource converter, but is not the same thing. SEE ALSO Chapter 18, The Layout Widget: A Tutorial, Chapter 19, The Layout Widget: The Details, XmtCreateLayout(), XmtCreateLayoutCol(), XmtCreateLayoutRow(), XmtLayoutBox, XmtLayoutConvertSizeToPixels(), XmtLayoutDisableLayout(), XmtLayoutEnableLayout(), XmtLayoutPixmap, XmtLayoutSeparator, XmtLayoutSpace, XmtLayoutString, XmtRegisterLayoutParser(), XmtRegisterLayoutCreateMethod(). Xmt Motif Tools XmtLayout(3)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtLayout&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>