


XmDialogShell(3X)					    XmDialogShell(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmDDiiaallooggSShheellll	- The DialogShell widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//DDiiaallooggSS..hh>>

DESCRIPTION
  Modal	and modeless dialogs use DialogShell as	the Shell parent.  Dialog-
  Shell	widgets	cannot be iconified.  Instead, all secondary DialogShell
  widgets associated with an ApplicationShell widget are iconified and de-
  iconified as a group with the	primary	widget.

  The client indirectly	manipulates DialogShell	via the	convenience inter-
  faces	during creation, and it	can directly manipulate	its BulletinBoard-
  derived child.  Much of the functionality of DialogShell assumes that	its
  child	is a BulletinBoard subclass, although it can potentially stand alone.

  Setting XXmmNNhheeiigghhtt, XXmmNNwwiiddtthh, or XXmmNNbboorrddeerrWWiiddtthh for either a DialogShell or
  its managed child usually sets that resource to the same value in both the
  parent and the child.	 When an off-the-spot input method exists, the height
  and width of the shell may be	greater	than those of the managed child	in
  order	to accommodate the input method.  In this case setting XXmmNNhheeiigghhtt or
  XXmmNNwwiiddtthh for the shell does not necessarily set that resource	to the same
  value	in the managed child, and setting XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh	for the	child
  does not necessarily set that	resource to the	same value in the shell.

  For the managed child	of a DialogShell, regardless of	the value of the
  shell's XXmmNNaalllloowwSShheellllRReessiizzee, setting XXmmNNxx or XXmmNNyy sets the corresponding
  resource of the parent but does not change the child's position relative to
  the parent.  XXttGGeettVVaalluueess for the child's XXmmNNxx	or XXmmNNyy	yields the value of
  the corresponding resource in	the parent.  The _x and _y coordinates of	the
  child's upper	left outside corner relative to	the parent's upper left
  inside corner	are both zero minus the	value of XXmmNNbboorrddeerrWWiiddtthh.

  Note that the	_I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l allows a window
  manager to change or control the border width	of a reparented	top-level
  window.

  Classes

  DialogShell inherits behavior	and resources from CCoorree, CCoommppoossiittee, SShheellll,
  WWMMSShheellll, VVeennddoorrSShheellll,	and TTrraannssiieennttSShheellll classes.

  The class pointer is xxmmDDiiaallooggSShheellllWWiiddggeettCCllaassss.

  The class name is XXmmDDiiaallooggSShheellll.




  New Resources

  DialogShell defines no new resources but overrides the XXmmNNddeelleetteeRReessppoonnssee
  resource in the VVeennddoorrSShheellll class.


  Inherited Resources

  DialogShell inherits behavior	and resources from the following superc-
  lasses.  For a complete description of each resource,	refer to the man page
  for that superclass.

  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	XXmmNN or XXmmCC
  prefix and use the remaining letters.	 To specify one	of the defined values
  for a	resource in a .Xdefaults file, remove the XXmm prefix and	use the
  remaining letters (in	either lowercase or uppercase, but include any under-
  scores between words).  The codes in the access column indicate if the
  given	resource can be	set at creation	time (C), set by using XXttSSeettVVaalluueess
  (S), retrieved by using XXttGGeettVVaalluueess (G), or is not applicable	(N/A).

			 TTrraannssiieennttSShheellll	RReessoouurrccee SSeett
		______________________________________________
		NNaammee			DDeeffaauulltt		AAcccceessss
		      CCllaassss		      TTyyppee
		______________________________________________
		______________________________________________
		XmNtransientFor		NULL		CSG
		      XmCTransientFor	       Widget
		______________________________________________

			   VVeennddoorrSShheellll RReessoouurrccee	SSeett
	 ____________________________________________________________
	 NNaammee				DDeeffaauulltt		       AAcccceessss
	       CCllaassss			      TTyyppee
	 ____________________________________________________________
	 ____________________________________________________________
	 XmNaudibleWarning		XmBELL		       CSG
	       XmCAudibleWarning	       unsigned	char
	 ____________________________________________________________
	 XmNbuttonFontList		dynamic		       CSG
	       XmCButtonFontList	       XmFontList
	 ____________________________________________________________
	 XmNdefaultFontList		dynamic		       CG
	       XmCDefaultFontList	       XmFontList
	 ____________________________________________________________
	 XmNdeleteResponse		XmUNMAP		       CSG
	       XmCDeleteResponse	       unsigned	char
	 ____________________________________________________________
	 XmNinputMethod			NULL		       CSG
	       XmCInputMethod		       String
	 ____________________________________________________________
	 XmNkeyboardFocusPolicy		XmEXPLICIT	       CSG
	       XmCKeyboardFocusPolicy	       unsigned	char
	 ____________________________________________________________
	 XmNlabelFontList		dynamic		       CSG
	       XmCLabelFontList		       XmFontList
	 ____________________________________________________________
	 XmNmwmDecorations		-1		       CSG
	       XmCMwmDecorations	       int
	 ____________________________________________________________
	 XmNmwmFunctions		-1		       CSG
	       XmCMwmFunctions		       int
	 ____________________________________________________________
	 XmNmwmInputMode		-1		       CSG
	       XmCMwmInputMode		       int
	 ____________________________________________________________
	 XmNmwmMenu			NULL		       CSG
	       XmCMwmMenu		       String
	 ____________________________________________________________
	 XmNpreeditType			dynamic		       CSG
	       XmCPreeditType		       String
	 ____________________________________________________________
	 XmNshellUnitType		XmPIXELS	       CSG
	       XmCShellUnitType		       unsigned	char
	 ____________________________________________________________
	 XmNtextFontList		dynamic		       CSG
	       XmCTextFontList		       XmFontList
	 ____________________________________________________________
	 XmNuseAsyncGeometry		False		       CSG
	       XmCUseAsyncGeometry	       Boolean
	 ____________________________________________________________

			     WWMMSShheellll RReessoouurrccee SSeett
	    _______________________________________________________
	    NNaammee		     DDeeffaauulltt		     AAcccceessss
		  CCllaassss			   TTyyppee
	    _______________________________________________________
	    _______________________________________________________
	    XmNbaseHeight	     XtUnspecifiedShellInt   CSG
		  XmCBaseHeight		    int
	    _______________________________________________________
	    XmNbaseWidth	     XtUnspecifiedShellInt   CSG
		  XmCBaseWidth		    int
	    _______________________________________________________
	    XmNheightInc	     XtUnspecifiedShellInt   CSG
		  XmCHeightInc		    int
	    _______________________________________________________
	    XmNiconMask		     NULL		     CSG
		  XmCIconMask		    Pixmap
	    _______________________________________________________
	    XmNiconPixmap	     NULL		     CSG
		  XmCIconPixmap		    Pixmap
	    _______________________________________________________
	    XmNiconWindow	     NULL		     CSG
		  XmCIconWindow		    Window
	    _______________________________________________________
	    XmNiconX		     -1			     CSG
		  XmCIconX		    int
	    _______________________________________________________
	    XmNiconY		     -1			     CSG
		  XmCIconY		    int
	    _______________________________________________________
	    XmNinitialState	     NormalState	     CSG
		  XmCInitialState	    int
	    _______________________________________________________
	    XmNinput		     True		     CSG
		  XmCInput		    Boolean
	    _______________________________________________________
	    XmNmaxAspectX	     XtUnspecifiedShellInt   CSG
		  XmCMaxAspectX		    int
	    _______________________________________________________
	    XmNmaxAspectY	     XtUnspecifiedShellInt   CSG
		  XmCMaxAspectY		    int
	    _______________________________________________________
	    XmNmaxHeight	     XtUnspecifiedShellInt   CSG
		  XmCMaxHeight		    int
	    _______________________________________________________
	    XmNmaxWidth		     XtUnspecifiedShellInt   CSG
		  XmCMaxWidth		    int
	    _______________________________________________________
	    XmNminAspectX	     XtUnspecifiedShellInt   CSG
		  XmCMinAspectX		    int
	    _______________________________________________________
	    XmNminAspectY	     XtUnspecifiedShellInt   CSG
		  XmCMinAspectY		    int
	    _______________________________________________________
	    XmNminHeight	     XtUnspecifiedShellInt   CSG
		  XmCMinHeight		    int
	    _______________________________________________________
	    XmNminWidth		     XtUnspecifiedShellInt   CSG
		  XmCMinWidth		    int
	    _______________________________________________________
	    XmNtitle		     dynamic		     CSG
		  XmCTitle		    String
	    _______________________________________________________
	    XmNtitleEncoding	     dynamic		     CSG
		  XmCTitleEncoding	    Atom
	    _______________________________________________________
	    XmNtransient	     True		     CSG
		  XmCTransient		    Boolean
	    _______________________________________________________
	    XmNwaitForWm	     True		     CSG
		  XmCWaitForWm		    Boolean
	    _______________________________________________________
	    XmNwidthInc		     XtUnspecifiedShellInt   CSG
		  XmCWidthInc		    int
	    _______________________________________________________
	    XmNwindowGroup	     dynamic		     CSG
		  XmCWindowGroup	    Window
	    _______________________________________________________
	    XmNwinGravity	     dynamic		     CSG
		  XmCWinGravity		    int
	    _______________________________________________________
	    XmNwmTimeout	     5000 ms		     CSG
		  XmCWmTimeout		    int
	    _______________________________________________________

			      SShheellll RReessoouurrccee SSeett
    ______________________________________________________________________
    NNaammee			    DDeeffaauulltt			    AAcccceessss
	  CCllaassss				  TTyyppee
    ______________________________________________________________________
    ______________________________________________________________________
    XmNallowShellResize		    False			    CG
	  XmCAllowShellResize		   Boolean
    ______________________________________________________________________
    XmNcreatePopupChildProc	    NULL			    CSG
	  XmCCreatePopupChildProc	   XtCreatePopupChildProc
    ______________________________________________________________________
    XmNgeometry			    NULL			    CSG
	  XmCGeometry			   String
    ______________________________________________________________________
    XmNoverrideRedirect		    False			    CSG
	  XmCOverrideRedirect		   Boolean
    ______________________________________________________________________
    XmNpopdownCallback		    NULL			    C
	  XmCCallback			   XtCallbackList
    ______________________________________________________________________
    XmNpopupCallback		    NULL			    C
	  XmCCallback			   XtCallbackList
    ______________________________________________________________________
    XmNsaveUnder		    True			    CSG
	  XmCSaveUnder			   Boolean
    ______________________________________________________________________
    XmNvisual			    CopyFromParent		    CSG
	  XmCVisual			   Visual *
    ______________________________________________________________________

			    CCoommppoossiittee RReessoouurrccee SSeett
	     _____________________________________________________
	     NNaammee		       DDeeffaauulltt		    AAcccceessss
		   CCllaassss		     TTyyppee
	     _____________________________________________________
	     _____________________________________________________
	     XmNchildren	       NULL		    G
		   XmCReadOnly		      WidgetList
	     _____________________________________________________
	     XmNinsertPosition	       NULL		    CSG
		   XmCInsertPosition	      XtOrderProc
	     _____________________________________________________
	     XmNnumChildren	       0		    G
		   XmCReadOnly		      Cardinal
	     _____________________________________________________

			      CCoorree RReessoouurrccee SSeett
     ____________________________________________________________________
     NNaammee				   DDeeffaauulltt		   AAcccceessss
	   CCllaassss				 TTyyppee
     ____________________________________________________________________
     ____________________________________________________________________
     XmNaccelerators			   dynamic		   CSG
	   XmCAccelerators			  XtAccelerators
     ____________________________________________________________________
     XmNancestorSensitive		   dynamic		   G
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNbackground			   dynamic		   CSG
	   XmCBackground			  Pixel
     ____________________________________________________________________
     XmNbackgroundPixmap		   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderColor			   XtDefaultForeground	   CSG
	   XmCBorderColor			  Pixel
     ____________________________________________________________________
     XmNborderPixmap			   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderWidth			   1			   CSG
	   XmCBorderWidth			  Dimension
     ____________________________________________________________________
     XmNcolormap			   dynamic		   CG
	   XmCColormap				  Colormap
     ____________________________________________________________________
     XmNdepth				   dynamic		   CG
	   XmCDepth				  int
     ____________________________________________________________________
     XmNdestroyCallback			   NULL			   C
	   XmCCallback				  XtCallbackList
     ____________________________________________________________________
     XmNheight				   dynamic		   CSG
	   XmCHeight				  Dimension
     ____________________________________________________________________
     XmNinitialResourcesPersistent	   True			   C
	   XmCInitialResourcesPersistent	  Boolean
     ____________________________________________________________________
     XmNmappedWhenManaged		   True			   CSG
	   XmCMappedWhenManaged			  Boolean
     ____________________________________________________________________
     XmNscreen				   dynamic		   CG
	   XmCScreen				  Screen *
     ____________________________________________________________________
     XmNsensitive			   True			   CSG
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNtranslations			   dynamic		   CSG
	   XmCTranslations			  XtTranslations
     ____________________________________________________________________
     XmNwidth				   dynamic		   CSG
	   XmCWidth				  Dimension
     ____________________________________________________________________
     XmNx				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________
     XmNy				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________

  Translations

  There	are no translations for	XmDialogShell.

RELATED	INFORMATION
  CCoommppoossiittee((33XX)), CCoorree((33XX)), SShheellll((33XX)), TTrraannssiieennttSShheellll((33XX)), WWMMSShheellll((33XX)),
  VVeennddoorrSShheellll((33XX)), and XXmmCCrreeaatteeDDiiaallooggSShheellll((33XX)).
















































