XmFrame(Xm) 6 January 1993 XmFrame(Xm) Name XmFrame - the Frame widget class Syntax #include <Xm/Frame.h> Description Frame is a very simple manager used to enclose a single work area child in a border drawn by Frame. It uses the Manager class resources for border drawing and performs geometry management so that its size always matches its child's outer size plus the Frame's margins and shadow thick- ness. Frame is most often used to enclose other managers when the application developer desires the manager to have the same border appearance as the primitive widgets. Frame can also be used to enclose primitive widgets that do not support the same type of border drawing. This gives visual consistency when you develop applications using diverse widget sets. Constraint resources are used to designate a child as the Frame title, align its text, and control its vertical alignment in relation to Frame's top shadow. The title appears only at the top of the Frame. If the Frame's parent is a Shell widget, XmNshadowType defaults to XmSHADOWOUT, and Manager's resource XmNshadowThickness defaults to 1. If the Frame's parent is not a Shell widget, XmNshadowType defaults to XmSHADOWETCHEDIN, and Manager's resource XmNshadowThickness defaults to 2. Classes Frame inherits behavior and resources from the Core, Composite, Con- straint, and XmManager classes. The class pointer is xmFrameWidgetClass. The class name is XmFrame. New resources The following table defines a set of widget resources used by the pro- grammer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the ``XmN'' or ``XmC'' prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the ``Xm'' prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable (N/A). XmFrame resource set ____________________________________________________________________________ Name Class Type Default Access ____________________________________________________________________________ XmNmarginWidth XmCMarginWidth Dimension 0 CSG XmNmarginHeight XmCMarginHeight Dimension 0 CSG XmNshadowType XmCShadowType unsigned char dynamic CSG XmNmarginWidth Specifies the padding space on the left and right sides between Frame's child and Frame's shadow drawing. XmNmarginHeight Specifies the padding space on the top and bottom sides between Frame's child and Frame's shadow drawing. When a title is present, the top margin equals the value specified by this resource plus the distance (if any) that the title extends below the top shadow. XmNshadowType Describes the drawing style for Frame. This resource can have the following values: + XmSHADOWIN -- draws Frame so that it appears inset. This means that the bottom shadow visuals and top shadow visuals are reversed. + XmSHADOWOUT -- draws Frame so that it appears outset. This is the default if Frame's parent is a Shell widget. + XmSHADOWETCHEDIN -- draws Frame using a double line giving the effect of a line etched into the window. The thickness of the double line is equal to the value of XmNshadowThickness. This is the default when Frame's parent is not a Shell widget. + XmSHADOWETCHEDOUT -- draws Frame using a double line giving the effect of a line coming out of the window. The thickness of the double line is equal to the value of XmNshadow- Thickness. XmFrame constraint resource set ______________________________________________________________________________ Name Class Type Default Access ______________________________________________________________________________ XmNchildType XmCChildType unsigned char XmFRAME_WORKAREA_CHILD XmNchildHorizontal-XmCChildHorizontal-unsigned char XmALIGNMENT_BEGINNING Alignment Alignment XmNchildHorizontal-XmCChildHorizontal-Dimensiondynamic CSG Spacing Spacing XmNchildVertical- XmCChildVertical- unsigned char XmALIGNMENT_CENTER Alignment Alignment XmNchildType Specifies whether a child is a title or work area. Frame supports a single title and/or work area child. The possible values are: + XmFRAMETITLECHILD + XmFRAMEWORKAREACHILD + XmFRAMEGENERICCHILD The Frame geometry manager ignores any child of type XmFRAMEGENERICCHILD. XmNchildHorizontalAlignment Specifies the alignment of the title. This resource has the fol- lowing values: + XmALIGNMENTBEGINNING + XmALIGNMENTCENTER + XmALIGNMENTEND See the description of XmNalignment in the XmLabel man page for an explanation of these values. XmNchildHorizontalSpacing Specifies the minimum distance between either edge of the title text and the inner edge of the Frame shadow. Clipping of the title text occurs in order to maintain this spacing. The default value is the margin width of the Frame. XmNchildVerticalAlignment Specifies the vertical alignment of the title text, or the title area in relation to the top shadow of the Frame. + XmALIGNMENTBASELINEBOTTOM -- causes the baseline of the title to align vertically with the top shadow of the Frame. In the case of a multi-line title, the baseline of the last line of text aligns vertically with the top shadow of the Frame. + XmALIGNMENTBASELINETOP -- causes the baseline of the first line of the title to align vertically with the top shadow of the Frame. + XmALIGNMENTWIDGETTOP -- causes the bottom edge of the title area to align vertically with the top shadow of the Frame. + XmALIGNMENTCENTER -- causes the center of the title area to align vertically with the top shadow of the Frame. + XmALIGNMENTWIDGETBOTTOM -- causes the top edge of the title area to align vertically with the top shadow of the Frame. Inherited resources Frame inherits behavior and resources from the following superclasses. For a complete description of each resource, refer to the man page for that superclass. XmManager resource set _____________________________________________________________________________ Name Class Type Default Access _____________________________________________________________________________ XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG XmNbottomShadowPixmapXmCBottomShadowPixmapPixmap XmUNSPEC- CSG IFIED_PIXMAP XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNinitialFocus XmCInitialFocus Widget NULL CSG XmNnavigationType XmCNavigationType XmNavigationType XmTAB_GROUP CSG XmNshadowThickness XmCShadowThickness Dimension dynamic CSG XmNstringDirection XmCStringDirection XmStringDirectiondynamic CG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean True CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG Composite resource set ____________________________________________________________________________ Name Class Type Default Access ____________________________________________________________________________ XmNchildren XmCReadOnly WidgetList NULL G XmNinsertPosition XmCInsertPosition XtOrderProc NULL CSG XmNnumChildren XmCReadOnly Cardinal 0 G Core resource set _______________________________________________________________________________ Name Class Type Default Access _______________________________________________________________________________ XmNaccelerators XmCAccelerators XtAcceleratorsdynamic CSG XmNancestorSensitiveXmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPix- XmCPixmap Pixmap XmUNSPEC- CSG map IFIED_PIXMAP XmNborderColor XmCBorderColor Pixel XtDefaultForegroundCSG XmNborderPixmap XmCPixmap Pixmap XmUNSPEC- CSG IFIED_PIXMAP XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackListNULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResources-XmCInitialResources-Boolean True C Persistent Persistent XmNmappedWhen- XmCMappedWhen- Boolean True CSG Managed Managed XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslationsdynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG Translations XmFrame inherits translations from XmManager. See also Composite(Xm), Constraint(Xm), Core(Xm), XmCreateFrame(Xm) and XmManager(Xm).