SgVisualDrawingArea(3X)
SgVisualDrawingArea - A drawing area in an alternate visual
As shipped in IRIX 6.5.30. Last changed in IRIX 6.5.22.
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 2.1. 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 change 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), 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 produces 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_COLORMAP_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 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 ____________________________________________________________________________ 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), SgVisualDrawingAreaUninstallColormap(3X), XmDrawingArea(3X),Primitive(3X), Core(3X)