XmScreen man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

XmScreen(3X)			   OSF/Motif			  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 func‐
       tion 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 cre‐
       ating 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
	  ──────────────────────────────────────────────────────────────────
	  Name				      Default		     Access
		Class				    Type
	  ──────────────────────────────────────────────────────────────────
	  ──────────────────────────────────────────────────────────────────
	  XmNdarkThreshold		      dynamic		     C
		XmCDarkThreshold		     int
	  ──────────────────────────────────────────────────────────────────
	  XmNdefaultCopyCursorIcon	      NULL		     CSG
		XmCDefaultCopyCursorIcon	     Widget
	  ──────────────────────────────────────────────────────────────────
	  XmNdefaultInvalidCursorIcon	      NULL		     CSG
		XmCDefaultInvalidCursorIcon	     Widget
	  ──────────────────────────────────────────────────────────────────

	  XmNdefaultLinkCursorIcon	      NULL		     CSG
		XmCDefaultLinkCursorIcon	     Widget
	  ──────────────────────────────────────────────────────────────────
	  XmNdefaultMoveCursorIcon	      NULL		     CSG
		XmCDefaultMoveCursorIcon	     Widget
	  ──────────────────────────────────────────────────────────────────
	  XmNdefaultNoneCursorIcon	      NULL		     CSG
		XmCDefaultNoneCursorIcon	     Widget
	  ──────────────────────────────────────────────────────────────────
	  XmNdefaultSourceCursorIcon	      NULL		     CSG
		XmCDefaultSourceCursorIcon	     Widget
	  ──────────────────────────────────────────────────────────────────
	  XmNdefaultValidCursorIcon	      NULL		     CSG
		XmCDefaultValidCursorIcon	     Widget
	  ──────────────────────────────────────────────────────────────────
	  XmNfont			      NULL		     CSG
		XmCFont				     XFontStruct *
	  ──────────────────────────────────────────────────────────────────
	  XmNforegroundThreshold	      dynamic		     C
		XmCForegroundThreshold		     int
	  ──────────────────────────────────────────────────────────────────
	  XmNhorizontalFontUnit		      dynamic		     CSG
		XmCHorizontalFontUnit		     int
	  ──────────────────────────────────────────────────────────────────
	  XmNlightThreshold		      dynamic		     C
		XmCLightThreshold		     int
	  ──────────────────────────────────────────────────────────────────
	  XmNmenuCursor			      arrow		     C
		XmCCursor			     String
	  ──────────────────────────────────────────────────────────────────
	  XmNmoveOpaque			      False		     CSG
		XmCMoveOpaque			     Boolean
	  ──────────────────────────────────────────────────────────────────
	  XmNunpostBehavior		      XmUNPOST_AND_REPLAY    CSG
		XmCUnpostBehavior		     unsigned char
	  ──────────────────────────────────────────────────────────────────
	  XmNverticalFontUnit		      dynamic		     CSG
		XmCVerticalFontUnit		     int
	  ──────────────────────────────────────────────────────────────────
       An integer between 0 and 100, inclusive, that specifies a level of per‐
       ceived  brightness  for	a  color.   If the perceived brightness of the
       background color is below this level, Motif treats  the	background  as
       "dark"  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.	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
       default icon is used.  Specifies the DragIcon used to indicate that the
       cursor is over an invalid drop site during a  drag  operation  when  no
       other pixmap symbol is specified by the application.  If NULL, a system
       default icon is used.  Specifies the DragIcon used during a drag opera‐
       tion  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 indicate that the
       cursor is not over a drop site during a drag operation  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  XmN‐
       sourceCursorIcon	 is  not  provided  by	the  DragContext, or it is not
       usable.	If NULL, a system default icon is used.	 Specifies the	DragI‐
       con used to indicate that the cursor is over a valid drop site during a
       drag operation 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  XmNverticalFontUnit.
       When  an application is initialized, this resource can be supplied in a
       resource file or through the standard command line options -fn,	-font,
       and  -xrm.   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 equal to or below this level, Motif treats
       the background as "dark" when  computing	 the  default  foreground  and
       highlight  colors.  If the perceived brightness of the background color
       is above this level, Motif treats the background as "light"  when  com‐
       puting  the  default  foreground	 and highlight colors.	When the back‐
       ground 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  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 horizontal component of the font units used by
       XmConvertUnits, and  is	used  to  interpret  the  values  of  geometry
       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 specified in XmNfont.  If no ini‐
       tial value is supplied for this resource or for XmNfont, the default is
       10.

       If a call to XtSetValues specifies a value  for	XmNhorizontalFontUnit,
       this resource is set to that value.  If a call to XtSetValues specifies
       a value for XmNfont but not for XmNhorizontalFontUnit, 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	 AVER‐
       AGE_WIDTH  property  divided  by	 10.  If the font has no AVERAGE_WIDTH
       property but has a QUAD_WIDTH property, the horizontal 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 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.  Sets a  variable  that  con‐
       trols  the  cursor  used	 whenever this application posts a menu.  This
       resource can be specified only once at application 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	 func‐
       tion  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.

      X_cursor		    dotbox	   man		       sizing
      arrow		    double_arrow   middlebutton	       spider
      based_arrow_down	    draft_large	   mouse	       spraycan
      based_arrow_up	    draft_small	   pencil	       star
      boat		    draped_box	   pirate	       target
      bogosity		    exchange	   plus		       tcross
      bottom_left_corner    fleur	   question_arrow      top_left_arrow
      bottom_right_corner   gobbler	   right_ptr	       top_left_corner
      bottom_side	    gumby	   right_side	       top_right_corner
      bottom_tee	    hand1	   right_tee	       top_side
      box_spiral	    hand2	   rightbutton	       top_tee
      center_ptr	    heart	   rtl_logo	       trek

      circle		    icon	   sailboat	       ul_angle
      clock		    iron_cross	   sb_down_arrow       umbrella
      coffee_mug	    left_ptr	   sb_h_double_arrow   ur_angle
      cross		    left_side	   sb_left_arrow       watch
      cross_reverse	    left_tee	   sb_right_arrow      xterm
      crosshair		    leftbutton	   sb_up_arrow
      diamond_cross	    ll_angle	   sb_v_double_arrow
      dot		    lr_angle	   shuttle
       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
       representation of the window during the move.  If the value  is	False,
       the  operation displays an outline of the window.  Specifies the behav‐
       ior of an active menu posted in traversal mode when a  subsequent  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  hierar‐
       chy  without  replaying the event.  Specifies the vertical component of
       the font units used by XmConvertUnits and used to interpret the	values
       of geometry 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 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  XmNverticalFontUnit,
       this resource is set to that value.  If a call to XtSetValues specifies
       a value for XmNfont but not for XmNverticalFontUnit, this  resource  is
       set to a value computed from the new XmNfont.

       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	 prop‐
       erty  divided  by  1.8.	If the font has no PIXEL_SIZE property but has
       POINT_SIZE and RESOLUTION_Y properties, 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).

RELATED INFORMATION
       Core(3X), XmDisplay(3X), and XmGetXmScreen(3X).

								  XmScreen(3X)
[top]

List of man pages available for Ultrix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net