*** UNIX MANUAL PAGE BROWSER ***

XmScreen(3X) XmScreen(3X) NAME XmScreen - The Screen widget class SYNOPSIS #include <Xm/Screen.h> DESCRIPTION The XmScreen object is used by Motif widgets to store information that is specific to a screen. It also allows the toolkit to store certain information on widget hierarchies that would otherwise be unavailable. Each client has one XmScreen object for each screen that it accesses. An XmScreen object is automatically created when the application cre- ates the first shell on a screen (usually accomplished by a call to XtAppInitialize or XtAppCreateShell). It is not necessary to create an XmScreen object by any other means. An application can use the function XmGetXmScreen to obtain the widget ID of the XmScreen object for a given screen. An application cannot supply initial values for XmScreen resources as arguments to a call to any function that creates widgets. The applica- tion or user can supply initial values in a resource file. After creat- ing the first shell on the screen, the application can use XmGetXm- Screen to obtain the widget ID of the XmScreen object and then call XtSetValues to set the XmScreen resources. Classes Screen inherits behavior and resources from Core. The class pointer is xmScreenClass. The class name is XmScreen. 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 an .Xdefaults file, remove the XmN or XmC prefix and use the remaining letters. To specify one of the defined values for a resource in an .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). XmScreen Resource Set Class: XmCDarkThreshold Default: dynamic Type: int Access: C Class: XmCDefaultCopyCursorIcon Default: NULL Type: Widget Access: CSG Class: XmCDefaultInvalidCursorIcon Default: NULL Type: Widget Access: CSG Class: XmCDefaultLinkCursorIcon Default: NULL Type: Widget Access: CSG Class: XmCDefaultMoveCursorIcon Default: NULL Type: Widget Access: CSG Class: XmCDefaultNoneCursorIcon Default: NULL Type: Widget Access: CSG Class: XmCDefaultSourceCursorIcon Default: NULL Type: Widget Access: CSG Class: XmCDefaultValidCursorIcon Default: NULL Type: Widget Ac- cess: CSG Class: XmCFont Default: NULL Type: XFontStruct * Access: CSG Class: XmCForegroundThreshold Default: dynamic Type: int Access: C Class: XmCHorizontalFontUnit Default: dynamic Type: int Access: CSG Class: XmCLightThreshold Default: dynamic Type: int Access: C Class: XmCCursor Default: arrow Type: String Access: C Class: XmCMoveOpaque Default: False Type: Boolean Access: CSG Class: XmCUnpostBehavior De- fault: XmUNPOST_AND_REPLAY Type: unsigned char Access: CSG Class: Xm- CVerticalFontUnit Default: dynamic Type: int Access: CSG An integer between 0 and 100, inclusive, that specifies a level of perceived brightness for a color. If the perceived bright- ness of the background color is below this level, Motif treats the background as "dark" when computing default shadow and se- lect colors. If this resource is specified for a particular screen, it applies to widgets created on that screen; otherwise it applies to widgets created on all screens. The default value is implementation specific. Specifies the DragIcon used during a drag operation when the operation is a copy and no other pixmap is specified by the application. If NULL, a system de- fault icon is used. Specifies the DragIcon used to indicate that the cursor is over an invalid drop site during a drag oper- ation when no other pixmap symbol is specified by the applica- tion. If NULL, a system default icon is used. Specifies the DragIcon used during a drag operation when the operation is a link and no other pixmap is specified by the application. If NULL, a system default icon is used. Specifies the DragIcon used during a drag operation when the operation is a move and no other pixmap is specified by the application. If NULL, a system default icon is used. Specifies the DragIcon used to in- dicate that the cursor is not over a drop site during a drag op- eration when no other pixmap is specified by the application. If NULL, a system default icon is used. Specifies the depth-1 pixmap used as a cursor when an XmNsourceCursorIcon is not pro- vided by the DragContext, or it is not usable. If NULL, a sys- tem default icon is used. Specifies the DragIcon used to indi- cate that the cursor is over a valid drop site during a drag op- eration when no other pixmap is specified by the application. If NULL, a system default icon is used. Specifies a font for use in computing values for XmNhorizontalFontUnit and XmNverti- calFontUnit. When an application is initialized, this resource can be supplied in a resource file or through the standard com- mand line options -fn, -font, and -xrm. An integer between 0 and 100, inclusive, that specifies a level of perceived bright- ness for a color. If the perceived brightness of the background color is equal to or below this level, Motif treats the back- ground as "dark" when computing the default foreground and high- light colors. If the perceived brightness of the background color is above this level, Motif treats the background as "light" when computing the default foreground and highlight col- ors. When the background is "dark", the default foreground and highlight is white; when the background is "light", the default foreground and highlight is black. If this resource is speci- fied for a particular screen, it applies to widgets created on that screen; otherwise, it applies to widgets created on all screens. The default value is implementation specific. Speci- fies the horizontal component of the font units used by XmCon- vertUnits, and is used to interpret the values of geometry re- sources when the XmNshellUnitType resource of VendorShell or the XmNunitType resource of Gadget, Manager, or Primitive has the value Xm100TH_FONT_UNITS. If no initial value is supplied for this resource, the default is computed from the font specified in XmNfont. If no initial value is supplied for this resource or for XmNfont, the default is 10. If a call to XtSetValues specifies a value for XmNhorizontal- FontUnit, this resource is set to that value. If a call to XtSetValues specifies a value for XmNfont but not for XmNhori- zontalFontUnit, this resource is set to a value computed from the new XmNfont. A horizontal font unit is derived from a font as follows: If the font has an AVERAGE_WIDTH property, the horizontal font unit is the AVERAGE_WIDTH property divided by 10. If the font has no AVERAGE_WIDTH property but has a QUAD_WIDTH property, the hori- zontal font unit is the QUAD_WIDTH property. If the font has no AVERAGE_WIDTH or QUAD_WIDTH property, the horizontal font unit is the sum of the font structure's min_bounds.width and max_bounds.width divided by 2.3. An integer between 0 and 100, inclusive, that specifies a level of perceived brightness for a color. If the perceived brightness of the background color is above this level, Motif treats the background as "light" when computing default shadow and select colors. If this resource is specified for a particular screen, it applies to widgets created on that screen; otherwise, it applies to widgets created on all screens. The default value is implementation specific. Sets a variable that controls the cursor used whenever this application posts a menu. This resource can be specified only once at ap- plication startup time, either by placing it within a defaults file or by using the -xrm command line argument. For example: myProg -xrm "*menuCursor: arrow" The menu cursor can also be selected in the program through the function XmSetMenuCursor. The following is a list of acceptable cursor names. If the application does not specify a cursor or if an invalid name is supplied, the default cursor (an arrow pointing up and to the right) is used. l l l. X_cursor fleur sailboat arrow gob- bler sb_down_arrow based_arrow_down gumby sb_h_dou- ble_arrow based_arrow_up hand1 sb_left_arrow boat hand2 sb_right_arrow bogosity heart sb_up_arrow bottom_left_corner icon sb_v_double_arrow bottom_right_cor- ner iron_cross shuttle bottom_side left_ptr sizing bot- tom_tee left_side spider box_spiral left_tee spraycan center_ptr leftbutton star circle ll_angle target clock lr_angle tcross coffee_mug man top_left_arrow cross middlebutton top_left_corner cross_re- verse mouse top_right_corner crosshair pencil top_side diamond_cross pirate top_tee dot plus trek dotbox ques- tion_arrow ul_angle double_arrow right_ptr umbrella draft_large right_side ur_angle draft_small right_tee watch draped_box rightbut- ton xterm exchange rtl_logo Specifies whether an interactive operation that moves a window, such as tearing off and dragging a tear-off menu or moving a window in MWM, displays an outline of the window or a representation of the window itself during the move. If the value is True, the operation displays a repre- sentation of the window during the move. If the value is False, the operation displays an outline of the window. Specifies the behavior of an active menu posted in traversal mode when a sub- sequent menu button selection is made outside the posted menu. When the value is XmUNPOST_AND_REPLAY, the resource unposts the menu hierarchy and causes the server to replay the event to the window in which the pointer is located. When the value is XmUNPOST, the resource unposts the hierarchy without replaying the event. Specifies the vertical component of the font units used by XmConvertUnits and used to interpret the values of geom- etry resources when the XmNshellUnitType resource of VendorShell or the XmNunitType resource of Gadget, Manager, or Primitive has the value Xm100TH_FONT_UNITS. If no initial value is supplied for this resource, the default is computed from the font speci- fied in XmNfont. If no initial value is supplied for this re- source or for XmNfont, the default is 10. If a call to XtSetValues specifies a value for XmNverticalFontU- nit, this resource is set to that value. If a call to XtSetVal- ues specifies a value for XmNfont but not for XmNverticalFontU- nit, this resource is set to a value computed from the new XmN- font. A vertical font unit is derived from a font as follows: If the font has a PIXEL_SIZE property, the vertical font unit is the PIXEL_SIZE property divided by 1.8. If the font has no PIXEL_SIZE property but has POINT_SIZE and RESOLUTION_Y proper- ties, the vertical font unit is the product of the POINT_SIZE and RESOLUTION_Y properties divided by 1400. If the font has no PIXEL_SIZE, POINT_SIZE, or RESOLUTION_Y properties, the vertical font unit is the sum of the font structure's max_bounds.ascent and max_bounds.descent divided by 2.2. Inherited Resources All of the superclass resources inherited by XmScreen are designated N/A (not applicable). SEE ALSO Core(3X), XmDisplay(3X), XmGetXmScreen(3X) XmScreen(3X)