sun® microsystems SunView System Programmer's Guide Part Number: 800-1784-11 Revision A of 27 March, 1990 Sun Workstation and the Sun logo are trademarks of Sun Microsystems, Incorporated. SunView is a trademark of Sun Microsystems, Incorporated. UNIX® is a registered trademark of AT&T. All other products or services mentioned in this document are identified by the trademarks or service marks of their respective companies or organizations. Copyright © 1982, 1983, 1984, 1985, 1986, 1987, 1988,1990 Sun Microsystems, Inc. - Printed in U.S.A. All rights reserved. No part of this work covered by copyright hereon may be reproduced in any fonn or by any means - graphic, electronic, or mechanical - including photocopying, recording, taping, or storage in an infonuation retrieval system, without the prior written permission of the copyright owner. Restricted rights legend: use, duplication, or disclosure by the U.S. government is subject to restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227-7013 and in similar clauses in the FAR and NASA FAR Supplement. The Sun Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun ack­ nowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user inter­ faces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun's licensees. This product is protected by one or more of the following U.S. patents: 4,777,4854,688,1904,527,2324,745,407 4,679,0144,435,7924,719,5694,550,368 in addition to foreign patents and applications pending. Contents Chapter 1 Introduction .......................................................................................................... 1 What is Sun View? ........................................................................................................ 1 Changes From Release 2.0 ...................................................................................... 1 Organization of Documentation ............. ............... ......... ...... ......... .................. ..... 1 Compatibility ............................................................................................................. 1 Changes in Release 4.0 ........................................................................................ 2 Changes in Release 4.1 ........................................................................................ 2 Chapter 2 Overview ................................................................................................................ 3 2.1. SunView Architecture ................................................................................................... 3 2.2. Document Outline ........................................................................................................... 3 Chapter 3 Sun View System Model ............................................................................. 5 3.1. A Hierarchy of Abstractions ............................................................... ....................... 5 Data Managers ................................................................................................................ 7 Data Representations .................................................................................................. 7 3.2. Model Dynamics 7 Tiles and the Agent 8 Windows 8 Desktop ......., ...... ,.............. " .... "................................ "............... ;; ,.... ~;:.;.:.: ... ~".. ,..... !.:;.f;~': ... (.:.:'~:;:;;; ••• :::::::> Loc~ng ......., ......................................... , ....................... "";,;;.,';;; ..... ~;;;; .. ~, .. ;, ..... ~ ...... ,...... ;; ... : Colormap Sharing ....................." .... "........................... ,,;;:; .. ;...... ';;; .. ,.,., .... '.;;", ..... ,,;,.:., .. ', ........ :':':::::::: Works~tions ......., ............. , ............. " ........... ,...................................... ;;;;;,,,.; .......' .. ;;;.;.,;.,.;; .... 11 - iii- Contents - Continued Chapter 4 The Agent & Tiles .......................................................................................... 13 4.1. Registering a Tile With the Agent ......................................................................... 13 Laying Out Tiles ........................................................................................................... 14 Dynamically Changing Tile Flags ...................................................................... 15 Extracting Tile Data .................................................................................................... 15 4.2. Notifications From the Agent ................................................................................... 15 4.3. Posting Notifications Through the Agent .......................................................... 16 4.4. Removing a Tile From the Agent ........................................................................... 18 Chapter 5 Windows ................................................................................................................. 19 5.1. Window Creation, Destruction, and Reference .............................................. 19 A New Window ............................................................................................................. 19 An Existing Window .................................................................................................. 20 References to Windows ............................................................................................. 20 5.2. Window Geometry .......................................................................................................... 21 Querying Dimensions ........................................................................................... 21 The Saved Rect .................................................................................... ,...................... 22 5.3. The Window Hierarchy ................................................................................................ 22 Setting Window Links ............................................................................................... 22 Activating the Window ............................................................................................. 23 Defaults .................................................................... .................. ................................... 23 Modifying Window Relationships ...................................................................... 24 Window Enumeration ................................................................................................ 25 Enumerating Window Offspring .................................................................... 25 Fast Enumeration of the Window Tree ....................................................... 26 5.4. Pixwin Creation and Destruction ............................................................................ 26 Creation ......................................................................................................................... 26 Region ............................................................................................................................ 27 Retained Image ......................................................................................................... 27 Bell .................................................................................................................................. 27 Destruction ............................................................. ..................................................... 27 5.5. Choosing Input .................................................................................................................. 27 Input Mask ........................................................................................................................ 27 -iv- Contents - Continued Manipulating the Mask Contents ................................................................... 28 Setting a Mask ........................................................................................................... 28 Querying a Mask ...................................................................................................... 29 The Designee ................................................................................................................... 29 5.6. Reading Input ..................................................................................................................... 29 Non-blocking Input ................................................................................................ 29 Asynchronous Input ............................................................................................... 29 Events Pending ......................................................................................................... 30 5.7. User Data .............................................................................................................................. 30 5.8. Mouse Position ................................................................................................................. 30 5.9. Providing for Naive Programs ................................................................................. 31 Which Window to Use ............................................................................................... 31 The Blanket