SgVisualDrawingArea(3X)
SgVisualDrawingArea --A drawing area in an alternate visual
Showing IRIX 6.5.30 (default release). Unchanged since IRIX 6.5.
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 back- ground. Since the SgVisualDrawingArea is a subclass of XmManager, it can have chil- dren. 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 program- mer 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 in- clude any underscores between words). The codes in the access column indi- cate 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 SgNditherBackground If the visual is a TrueColor or StaticColor visual, and the wid- get 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 WM_COL- ORMAP_WINDOWS property on the shell containing the widget, so that the window manager installs the colormap when that applica- tion 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 applica- tion needs more direct control over when the colormaps are in- stalled, this resource could be false. In such a case, SgVisual- DrawingAreaInstallColormap(3X) and SgVisualDrawingAreaUninstall- Colormap(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 su- perclasses. 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 INFORMATION SgVisualDrawingAreaInstallColormap(3X), SgVisualDrawingAreaUninstallCol- ormap(3X), XmDrawingArea(3X),Primitive(3X), Core(3X) VisualDrawingArea(3X)