VisualDrawingArea(3X)VisualDrawingArea(3X)NAMESgVisualDrawingArea — A drawing area in an alternate visual
SYNOPSIS
#include <Sgm/VisualDrawingA.h>
VERSION
This page documents the version of Sgm that accompanies Motif 1.2.
DESCRIPTIONSgVisualDrawingArea is a subclass of the Motif Drawing Area that allows
has a visual resource, allowing the widget to be placed into a visual
different than the rest of the application. It is useful for applica‐
tions that need to use multiple visuals, for example, running one win‐
dow in 24 bit RGB while the rest of the application is in 8 bit pseudo
color.
SgVisualDrawingArea also has the ability to create a TrueColor dithered
background to more closely match a requested background, and to set the
WM_COLORMAP_WINDOWS property to have the window manager install its
background.
Since the SgVisualDrawingArea is a subclass of XmManager, it can have
children. These children will automatically inherit the visual, col‐
ormap, and depth of the SgVisualDrawingArea. Thus, the SgVisual‐
DrawingArea can be used to chage the visual of a hierarchy of widgets.
Classes
SgVisualDrawingArea inherits behavior and resources from Core, XmMan‐
ager, and XmDrawingArea classes.
The class pointer is sgVisualDrawingAreaWidgetClass.
The class name is SgVisualDrawingArea.
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 val‐
ues 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, SgN, XmC, or SgC 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).
SgVisualDrawingArea Resource Set
Name Class Type Default Access
───────────────────────────────────────────────────────────────────────────────
SgNditherBackground SgCDitherBackground Boolean False CG
SgNinstallColormap SgCInstallColormap Boolean False CG
XmNvisual XmCVisual Visual * CopyFromParent CG
If the visual is a TrueColor or StaticColor visual, and the widget is
unable to get an exact match for the requested background color, the
widget will attempt to produce a dithered pixmap that produceds a
closer background to that requested. If it finds one, it will automat‐
ically set the XmNbackgroundPixmap resource to this pixmap. The
resource is ignored in any other visual, or if XmNbackgroundPixmap is
already set. If true, specifies that the widget should set the WM_COL‐
ORMAP_WINDOWS property on the shell containing the widget, so that the
window manager installs the colormap when that application gets focus.
At least one window using each colormap should be listed in this prop‐
erty (even if the widgets are TrueColor), although if several widgets
share the same colormap it is only necessary to set this resource for
one of them. If the application needs more direct control over when
the colormaps are installed, this resource could be false. In such a
case, SgVisualDrawingAreaInstallColormap(3X) and SgVisual‐
DrawingAreaUninstallColormap(3X) may be used instead. Specifies the
visual in which to create the window. It must match the depth and col‐
ormap of the widget or a BadMatch error can result.
Inherited Resources
SgVisualDrawingArea inherits behavior and resources from the following
superclasses. For a complete description of each resource, refer to
the man page for that superclass.
XmDrawingArea Resource Set
Name Class Type Default Access
─────────────────────────────────────────────────────────────────────────────
XmNexposeCallback XmCCallback XtCallbackList NULL C
XmNinputCallback XmCCallback XtCallbackList NULL C
XmNmarginHeight XmCMarginHeight Dimension 10 CSG
XmNmarginWidth XmCMarginWidth Dimension 10 CSG
XmNresizeCallback XmCCallback XtCallbackList NULL C
XmNresizePolicy XmCResizePolicy unsigned char XmRESIZE_ANY CSG
XmManager Resource Set
Name Class Type Default Access
──────────────────────────────────────────────────────────────────────────────────────────────────
XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG
XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
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 0 CSG
XmNstringDirection XmCStringDirection XmStringDirection dynamic 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 XtAccelerators dynamic CSG
XmNancestorSensitive XmCSensitive Boolean dynamic G
XmNbackground XmCBackground Pixel dynamic CSG
XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG
XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
XmNborderWidth XmCBorderWidth Dimension 0 CSG
XmNcolormap XmCColormap Colormap dynamic CG
XmNdepth XmCDepth int dynamic CG
XmNdestroyCallback XmCCallback XtCallbackList NULL C
XmNheight XmCHeight Dimension dynamic CSG
XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C
XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG
XmNscreen XmCScreen Screen * dynamic CG
XmNsensitive XmCSensitive Boolean True CSG
XmNtranslations XmCTranslations XtTranslations dynamic CSG
XmNwidth XmCWidth Dimension dynamic CSG
XmNx XmCPosition Position 0 CSG
XmNy XmCPosition Position 0 CSG
RELATED INFORMATIONSgVisualDrawingAreaInstallColormap(3X), SgVisualDrawingAreaUninstall‐
Colormap(3X), XmDrawingArea(3X),Primitive(3X), Core(3X)VisualDrawingArea(3X)