Programming With the Xt Intrinsics Version 11, Release 3 HP 9000 Series 300/800 Computers HP Part Number 98794-90008 rli~ HEWLETT ~~ PACKARD Hewlett-Packard Company 1000 NE Circle Blvd., Corvallis OR 97330 NOTICE The information contained in this document is subject to change without notice. HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MANUAL, INCLUDING, BUT NOT UMITED TO, THE IMPUED WARRANTIES OF MER:::HANTABIUTY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or direct, indirect, special, incldentai or consequential damages in connection with the furnishing, performance, or use of this material. Copyright 1989 Hewlett-Packard Company. This document contains proprietary information which is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language without the prior written consent of Hewlett-Packard Company, except as provided below. The information contained in this document is subject to change without notice. Restricted Rights Legend Use, duplication or disclosure by the Government is subject to restrictions as set.forth in paragraph (b)(3)(B) of the Rights in Technicai Data and Software clause in DAR 7-104.9(8). Use of this manual and flexible disc(s) or tape cartridge(s) supplied for this pack is restricted to this product only. Additionai copies of the programs can be made for security and back-up purposes only. Resale of the programs in their present form or with aHerations, is expressly prohibited. Copyright 1987, 1988, Massachusetts Institute of Technology, Cambridge, Massachusetts. Parts of this software and documentation are based In part on software and documentation developed and distributed by Massachusetts Institute of Technology. Permission to use, copy, modify, and distribute only those parts for any purpose and without fee is hereby granted, provided that the above copyright notices appear in ail copies and that those copyright notices and this permission notice appear in supporting documentation, and that the names of Hewlett-Packard and M.I.T. not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. UNIX is a trademark of AT&T. Printing History New editions of this manual will incorporate all material updated since the previous edition. Update packages may be issued between editions and contain replacement and additional pages to be merged into the manual by the user. Each updated page will be indicated by a revision date at the bottom of the page. A vertical bar in the margin indicates the changes on each page. Note that pages that are rearranged due to changes on a previous page are not considered revised. The manual printing date and part number indicate its current edition. The printing date changes when a new edition is printed. (Minor corrections and updates that are incorporated at reprint do not cause the date to change.) The manual part number changes when extensive technical changes are incorporated. July 1988 ... Edition 1 December 1988 ... Edition 2 September 1989 ... Edition 3 Contents 1 Intrinsics and Widgets ............................................................................................ 1-1 1.1 Terminology .......................................................................................................... 1-2 1.2 Intrinsics ...... ............ ...... ...... ............ .......... ........ ............ ............. ....... ....... ............ 1-3 1.3 Widgets .................................................................................................................. 1-5 1.3.1 Core Widgets .................................................................................................... 1-6 1.3.2 Composite Widgets .......................................................................................... 1-10 1.3.3 Constraint Widgets .......................................................................................... 1-11 1.4 Widget Classing .................................................................................................... 1-12 1.4.1 Widget Naming Conventions .......................................................................... 1-13 1.4.2 Widget Subclassing in Public .h Files ............................................................ 1-14 1.4.3 Widget Subclassing in Private .h Files ........................................................... 1-15 1.4.4 Widget Subclassing in .c Files ......................................................................... 1-17 1.4.5 Widget Class and Superclass Look Up ......................................................... 1-20 1.4.6 Widget Subclass Verification .......................................................................... 1-20 1.4.7 Superclass Chaining ......................................................................................... 1-21 1.4.8 Class Initialization ........... ...... ......... ...... ......... .................... ........ ....................... 1-22 1.4.9 Inheritance of Superclass Operations ............................................................ 1-24 1.4.10 Invocation of Superclass Operations ............................................................. 1-25 2 Widget Instantiation ............................................................................................... 2-1 2.1 Initializing the X Toolkit ................................ ................. .................... .......... ...... 2-2 2.2 Loading the Resource Database ........................................................................ 2-5 2.3 Parsing the Command Line ................................................................................ 2-7 2.4 Creating Widgets .................................................................................................. 2-9 2.4.1 Creating and Merging Argument Lists ......................................................... 2-10 2.4.2 Creating a Widget Instance ............................................................................ 2-11 2.4.3 Creating an Application Shell Instance ......................................................... 2-13 2.4.4 Widget Instance Initialization .... ................................. ........ ............................ 2-14 2.4.5 Constraint Widget Instance Initialization ..................................................... 2-15 2.4.6 Nonwidget Data Initialization ........................................................................ 2-16 2.5 Realizing Widgets ................................................................................................ 2-16 2.5.1 Widget Instance Window Creation ................................................................ 2-18 2.5.2 Window Creation Convenience Routine ...................................................... 2-19 2.6 Obtaining Window Information from a Widget ............................................... 2-20 2.6.1 U nrealizing Widgets ........................................................................................ 2-21 2.7 Destroying Widgets .............................................................................................. 2-22 2.7.1 Adding and Removing Destroy Callbacks .................................................... 2-23 2.7.2 Dynamic Data Deallocation ........................................................................... 2-24 Contents 1 2.7.3 Dynamic Constraint Data Deallocation ........................................................ 2-25 2.8 Exiting from an Application ............................................................................... 2-25 3 Composite Widgets and Their Children .............................................................. 3-1 3.1 Verifying the Class of a Composite Widget ...................................................... 3-2 3.2 Addition of Children to a Composite Widget .................................................. 3-3 3.3 Insertion Order of Children ................................................................................ 3-3 3.4 Deletion of Children ............................................................................................ 3-4 3.5 Adding and Removing Children from the Managed Set ................................ 3-4 3.5.1 Managing Children .......................................................................................... 3-4 3.5.2 Unmanaging Children ..................................................................................... 3-6 3.5.3 Determining if a Widget Is Managed ............................................................ 3-7 3.6 Controlling When Widgets Get Mapped .......................................................... 3-7 3.7 Constrained Composite Widgets ....................................................................... 3-8 4 Shell Widgets ............................................................................................................ 4-1 4.1 Shell Widget Definitions ..................................................................................... 4-2 4.1.1 ShellClassPart Definitions .............................................................................. 4-2 4.1.2 ShellPart Definition ......................................................................................... 4-5 4.1.3 ShellPart Default Values ................................................................................. 4-7 5 Pop-Up Widgets ......................................................................................................