home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / doc / Xaw / CH6.intro < prev    next >
Encoding:
Text File  |  1991-07-29  |  3.0 KB  |  85 lines
  1. .LP
  2. .bp
  3. .if e .bp  \" make sure we break on an odd page.
  4. \&
  5. .sp 1
  6. .ce 3
  7. \s+1\fBChapter 6\fP\s-1
  8.  
  9. \s+1\fBComposite and Constraint Widgets\fP\s-1
  10. .sp 2
  11. .nr H1 6
  12. .nr H2 0
  13. .nr H3 0
  14. .nr H4 0
  15. .nr H5 0
  16. .na
  17. .LP
  18. .XS
  19. Chapter 6 - Composite and Constraint Widgets
  20. .XE
  21. .LP
  22. These widgets may contain arbitrary widget children.  They implement a
  23. policy for the size and location of their children.  
  24. .IP \fBBox\fP 1i
  25. .IN "Box widget" ""
  26. This widget will pack its children as tightly as possible in
  27. non-overlapping rows.  
  28. .IP \fBDialog\fP 1i
  29. .IN "Dialog widget" ""
  30. An implementation of a commonly used interaction semantic to prompt for
  31. auxiliary input from the user, such as a filename.
  32. .IP \fBForm\fP 1i
  33. .IN "Form widget" ""
  34. A more sophisticated layout widget that allows the children to specify
  35. their positions relative to the other children, or to the edges of the Form.
  36. .IP \fBPaned\fP 1i
  37. .IN "Paned widget" ""
  38. Allows children to be tiled vertically or horizontally.  Controls are
  39. also provided to allow the user to dynamically resize the individual panes.
  40. .IP \fBPorthole\fP 1i
  41. .IN "Porthole widget" ""
  42. Allows viewing of a managed child which is as large as, or larger than its
  43. parent, typically under control of a Panner widget.
  44. .IP \fBTree\fP 1i
  45. .IN "Tree widget" ""
  46. Provides geometry managment of widgets arranged in a directed, acyclic graph.
  47. .IP \fBViewport\fP 1i
  48. .IN "Viewport widget" ""
  49. Consists of a frame, one or two scrollbars, and an inner window.  The
  50. inner window can contain all the data that is to be displayed.  This inner
  51. window will be clipped by the frame with the scrollbars controlling
  52. which section of the inner window is currently visible.
  53. .LP
  54. .NH 3
  55. A Brief Note on Geometry Management
  56. .IN "geometry management" ""
  57. .LP
  58. The geometry management semantics provided by the X Toolkit give full
  59. control of the size and position of a widget to the parent of that
  60. widget.  While the children are allowed to request a certain size or
  61. location, it is the parent who makes the final decision.  Many of the
  62. composite widgets here will deny any geometry request from their
  63. children by default.  If a child widget is not getting the expected size
  64. or location, it is most likely the parent disallowing a request, or
  65. implementing semantics slightly different than those expected by the
  66. application programmer.
  67. .LP
  68. If the application wishes to change the size or location of
  69. any widget it should make a call to \fBXtSetValues\fP.  This will
  70. .IN "XtSetValues" ""
  71. allow the widget to ask its parent for the new size or location.
  72. As noted above the parent is allowed to refuse this request,
  73. and the child must live with the result.  If the
  74. application is unable to achieve the desired semantics, then perhaps it
  75. should use a different composite widget.  Under no circumstances
  76. should an application programmer resort to \fBXtMoveWidget\fP or
  77. .IN "XtMoveWidget" ""
  78. \fBXtResizeWidget\fP; these functions are exclusively for the use of
  79. .IN "XtResizeWidget" ""
  80. Composite widget implementors.
  81. .LP
  82. For more information on geometry management consult the \fI\*(xT\fP.
  83.  
  84.  
  85.