Preface

This manual describes the various technologies available for integrating window applications running the Solaris^(TM) System Software, which consists of two parts: the operating system and windowing environment. Desktop Integration is defined as the ability to exchange and process data using the special features of the Solaris graphical user interface.

Who Should Use This Book

This guide is written for independent software vendors (ISVs) with previous experience developing in the X11 windowing environment, who wish to integrate their applications with other applications and tools on the Solaris^(TM) desktop.

How This Book Is Organized

Chapter 1, "Desktop Integration,"provides an overall introduction to desktop integration and lists the available technologies.

Chapter 2, "The Selection Mechanism," describes the selections mechanism for copying or moving data between applications.

Chapter 3, "Drag and Drop," describes the application program interface and provides working XView^(TM) code examples.

Chapter 4, "Implementing Drag and Drop with DeskSet," tells how to drag and drop between DeskSet Applications.

Chapter 5, "Classing Engine," describes the principles, organization, and operation of the Classing Engine, and working example code is supplied.

Chapter 6, "The ToolTalk Service," provides the background and a short tutorial for process-oriented messaging capabilities of the ToolTalk^(TM) service.

Chapter 7, "The ToolTalk Service and DeskSet Integration," discusses how the ToolTalk protocol is used with Solaris DeskSet applications.

Appendix A, "Drag and Drop User Interface Specification," provides the drag and drop user interface specification.

Appendix B, "Examining a Classing Engine Database," provides a procedure for producing an ASCII printout of an existing Classing Engine database.

Appendix C, "Vendor Data Type Registration," describes the process used to reserve a vendor-unique data type designator.

Appendix D, "ToolTalk Example Program for XView Toolkit," shows a ToolTalk program.

Appendix E, "Drag and Drop Programming Example for XView Toolkit,"

shows a program integrated with the DeskSet.

Appendix F, "The ToolTalk Desktop Services Message Set," details all ToolTalk messages for Desktop Services valid for this release.

Appendix G, "The ToolTalk Document and Media Exchange Message Set,"

details all ToolTalk messages for Media Exchange valid for this release.

Related Books

The X Window System Programming and Applications with Xt, OPEN LOOK Edition, Prentice Hall, 1992

OLIT Reference Manual, SunSoft, 1994

X Window System Programming and Applications with Xt .- OPEN LOOK Edition, by John Pew, published by Prentice Hall, 1992.

OLIT Quick Start Programmer's Guide, Part Number 801-5317-10, Sun Microsystems, Inc., 1994.

X Window System Toolkit, The Complete Programmer's Guide and Specification, Digital Press, 1992.

X Window System, The Complete Guide to Xlib, X Protocol, ICCCM, XLFD, Digital Press, 1992.

X Protocol Reference Manual, O'Reilly & Associates, Inc., 1990

XView Programming Manual, O'Reilly & Associates, Inc., 1991

XView Reference Manual, O'Reilly & Associates, Inc., 1991

ToolTalk User's Guide, SunSoft, 1994

ToolTalk Reference Guide, SunSoft, 1994

Writing Applications for Sun Systems, Volume I, A Guide for Macintosh^(R) Programmers, Addison Wesley, 1991

Applications achieve varying degrees of integration with the three integration technologies described in this manual. These technologies are: selections and drag and drop, the Classing Engine, and ToolTalk services. The diagram below directs you to further information sources.

What Typographic Changes and Symbols Mean

The following table describes the type changes and symbols used in this book.

Table P-1

Typeface or Symbol	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output, code samples	Edit your`.login` file. Use `ls -a` to list all files. `system% You have mail.`
*AaBbCc123*	Command-line placeholder: replace with a real name or value	To delete a file, type `rm` *filename*`.`
*AaBbCc123*	Book titles, new words or terms, or words to be emphasized	Read Chapter 6 in *User's Guide`.` These are called class* options. You *must* be root to do this.
Code samples are included in boxes and may display the following:
`%`	UNIX C shell prompt	`system%`
`$`	UNIX Bourne shell prompt	`system$`
`#`	Superuser prompt, either shell	`system#`