VisualDrawingArea(3X) UNIX System V VisualDrawingArea(3X)
NAME
SgVisualDrawingArea - 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.
DESCRIPTION
SgVisualDrawingArea 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 applications that need to use
multiple visuals, for example, running one window 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, colormap, and depth of the
SgVisualDrawingArea. Thus, the SgVisualDrawingArea can be
used to chage the visual of a hierarchy of widgets.
Classes
SgVisualDrawingArea inherits behavior and resources from
Core, XmManager, 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 programmer 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, 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),
Page 1 (printed 4/30/98)
VisualDrawingArea(3X) UNIX System V VisualDrawingArea(3X)
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
SgNditherBackground
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 automatically
set the XmNbackgroundPixmap resource to this
pixmap. The resource is ignored in any other
visual, or if XmNbackgroundPixmap is already set.
SgNinstallColormap
If true, specifies that the widget should set the
WMCOLORMAPWINDOWS 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 property (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
SgVisualDrawingAreaUninstallColormap(3X) may be
used instead.
XmNvisual Specifies the visual in which to create the
window. It must match the depth and colormap 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
Page 2 (printed 4/30/98)
VisualDrawingArea(3X) UNIX System V VisualDrawingArea(3X)
____________________________________________________________________________
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
Page 3 (printed 4/30/98)
VisualDrawingArea(3X) UNIX System V VisualDrawingArea(3X)
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 INFORMATION
SgVisualDrawingAreaInstallColormap(3X),
SgVisualDrawingAreaUninstallColormap(3X),
XmDrawingArea(3X),Primitive(3X), Core(3X)
Page 4 (printed 4/30/98)