Volume 7B: XView Reference Manual

Preface

This manual describes the XView attributes, callbacks, procedures, macros, data structures,

as well as additional reference material. XView (X Window-System-based Visual/Integrated

Environment for Workstations) is a user-interface toolkit to support interactive, graphics-

based applications running under the X Window System. This toolkit, developed by Sun

Microsystems, Inc., is derived from earlier toolkits for the SunView windowing system.

With over 2000 SunView applications in the workstation market, there are many program-

mers already familiar with SunView application programmer’s interface (API).

XView is based upon Xlib, the lowest level of the X Window System available to the pro-

grammer. While developing XView user interfaces does not require Xlib programming expe-

rience, there are good reasons for learning more about Xlib, especially if your application

renders graphics.

How to Use This Manual

The XView Reference Manual includes reference material for each of the XView attributes

and procedures, information about XView resources, and data structures. Within each sec-

tion, reference pages are organized alphabetically.

This book is designed to be used with the XView Programming Manual. The XView Pro-

gramming Manual provides an explanation of XView, including tutorial material and numer-

ous programming examples. To get the most out of the XView Programming Manual, you

will need the exact arguments for the attributes and the calling sequence for the callbacks

and procedures that this reference manual provides.

The following paragraphs briefly describe the contents of this book:

Section 1, XView Package Summary, provides an introduction to XView and provides a sum-

mary of each of the XView packages.

Section 2, XView Attributes, provides alphabetically arranged descriptions of all attributes,

and the callback procedures that are supplied by the application programmer.

Section 3, Procedures and Macros, provides alphabetically arranged descriptions of all the

XView procedures and macros.

Preface

Preface xi

Section 4, Data Types, lists the data types defined by XView.

Section 5, Event Codes, lists the event codes in numerical order by value.

Section 6, Command-line Arguments and XView Resources, lists the XView options that can

be set using command-line options. This section also lists the resources that XView uses to

define certain default values when an application is initialized.

Appendix A, Selection Compatibility Attributes, provides the attributes for the old selection

mechanism. A new selection package has been added in XView Version 3. The new selec-

tion package supports the standard XView API. The old selection mechanism is still sup-

ported in XView Version 3.

Appendix B, Selection Compatibility Procedures and Macros, provides the procedures and

macros for the old selection mechanism. A new selection package has been added in XView

Version 3. The new selection package supports the standard XView API. The old selection

mechanism is still supported in XView Version 3.

Appendix C, Textsw Action Attributes, provides the ACTION_* attributes that are available for

use with a client-supplied notify procedure. These attributes are not standard attributes and

cannot be used with xv_create(), xv_get(), or xv_set().

Font Conventions Used in This Manual

Italic is used for:

• UNIX pathnames, filenames, program names, user command names, and options

for user commands.

• New terms where they are introduced.

Typewriter Font is used for:

• Anything that would be typed verbatim into code, such as examples of source

code and text on the screen.

• XView packages.*

• The contents of include files, such as structure types, structure members, sym-

bols (defined constants and bit flags), and macros.

• XView and Xlib functions.

• Names of subroutines of the example programs.

Italic Typewriter Font

is used for:

• Arguments to XView functions, since they could be typed in code as shown but

are arbitrary.

*When referring to all members of a particular package, such as CANVAS, the notation CANVAS_* will be used. This

should not be interpreted as a C-language pointer construct.

xii XView Reference Manual

Helvetica Italics

are used for:

• Titles of examples, figures, and tables.

Boldface is used for:

• Sections and headings.

Related Documents

The C Programming Language by B. W. Kernighan and D. M. Ritchie.

The following documents are included on the X11 source tape:

OPEN LOOK Graphical User Interface Functional Specification

OPEN LOOK Graphical User Interface Style Guide

The following books in the X Window System series from O’Reilly & Associates, Inc. are

currently available:

Volume Zero — X Protocol Reference Manual

Volume One — Xlib Programming Manual

Volume Two — Xlib Reference Manual

Volume Three — X Window System User’s Guide

Volume Four — X Toolkit Intrinsics Programming Manual

Volume Five — X Toolkit Intrinsics Reference Manual

Volume Six A — Motif Programming Manual

Volume Six B — Motif Reference Manual

Volume Seven — XView Programming Manual

Volume Eight — X Administrator’s Guide

Quick Reference — The X Window System in a Nutshell

PHIGS

Programming Manual

PHIGS

Reference Manual

Pexlib Programming Manual

Pexlib Reference Manual

Preface

Preface xiii

Requests for Comments

Please write to tell us about any flaws you find in this manual or how you think it could be

improved, to help us provide you with the best documentation possible.

Our U.S. mail address, phone numbers, and e-mail addresses are as follows:

O’Reilly & Associates, Inc.

103 Morris Street, Suite A

Sebastopol, CA 95472

in USA 1-800-338-6887,

international [phone]

UUCP: uunet!ora!xview Internet: [e-mail]

Acknowledgements

The initial material for this manual was the appendices to the previous version of the XView

Programming Manual by Dan Heller. This material has been considerably expanded and

should be a helpful addition to the XView documentation.

Thanks to John Stone for all his help in preparing this manual. John dealt with formatting

issues and checked and re-checked all the new attributes. Special thanks also go to Darci

Chapman and Jon Lee for their assistance.

Dale Dougherty kept the big picture in sight and managed this project. Thanks to Lenny

Muellner, Stephen Spainhour, Kismet McDonough, Chris Reilley, and the rest of the produc-

tion and graphics team at O’Reilly and Associates who put the final manual together.

The XView developers at Sun Microsystems spent many hours going over many versions of

this manual. In particular, Chris Kasso added extensively to this material and answered

numerous questions. Thanks also go to Isa Hashim and Mitch Jerome for their comments and

additions. Darren Austin, Sri Atreya, Shirley Joe, and Shanmugh Natarajan reviewed this

manual and helped in numerous ways. Thanks also go to Tony Hillman, Bhaskar Prabhala,

Greg Kimura, and Stan Raichlen. Despite all the reviews, any errors that remain are my own.

– Thomas Van Raalte

xiv XView Reference Manual

This page intentionally left blank

to preserve original page counts.