All Manuals > CAPI User Guide

NextPrevTopIndex

Contents

Preface

1 Introduction to the CAPI

1.1 What is the CAPI?

1.2 The history of the CAPI

1.3 The CAPI model

1.3.1 CAPI Classes

2 Getting Started

2.1 Using the CAPI package

2.2 Creating a window

2.3 Linking code into CAPI elements

3 Creating Common Windows

3.1 Generic properties

3.1.1 Scroll bars

3.1.2 Background and foreground colors

3.1.3 Fonts

3.1.4 Mnemonics

3.1.4.1 Controlling Mnemonics

3.1.4.2 Mnemonics on Microsoft Windows

3.2 Specifying titles

3.2.1 Title panes

3.2.2 Specifying titles directly

3.2.2.1 Window titles

3.2.2.2 Titles for elements

3.3 Displaying and entering text

3.3.1 Display panes

3.3.2 Text input panes

3.3.3 Editor panes

3.4 Displaying formatted text

3.4.1 Rich text

3.4.2 HTML

3.5 Stream panes

3.5.1 Collector panes

3.5.2 Interactive streams

3.5.3 Listener panes

3.6 Miscellaneous button elements

3.6.1 Push buttons

3.6.2 Check buttons

3.6.3 Radio buttons

3.6.4 Mnemonics in buttons

3.7 Adding a toolbar to an interface

3.8 Tooltips

3.8.1 Tooltips for output panes

3.8.2 Tooltips for collections, elements and menu items

3.8.3 Tooltips for toolbar buttons

4 General Considerations

4.1 The correct thread for CAPI operations

4.2 Support for multiple monitors

5 Host Window System Configuration

5.1 Properties of the host window system

5.1.1 Using Windows themes

5.1.2 Matching resources

5.1.2.1 Matching resources on GTK+

5.1.2.2 Matching resources on X11/Motif

5.1.2.3 Resources for LispWorks CAPI applications

5.1.2.4 X resources for in-place completion windows

5.1.3 The break gesture

5.2 Using Motif

5.2.1 Using Motif on Linux, FreeBSD and x86/x64 Solaris

5.2.2 Using Motif on Macintosh

5.2.3 Using Motif on SPARC Solaris and HP-UX

6 Choices

6.1 Button classes

6.1.1 Push button panels

6.1.2 Radio button panels

6.1.3 Check button panels

6.1.4 Mnemonics in button panels

6.2 List panels

6.2.1 List interaction

6.2.2 Extended selection

6.2.3 Deselection, retraction, and actions

6.2.4 Selections

6.2.5 Images and appearance

6.2.6 Filters

6.3 Trees

6.3.1 Tree interaction

6.3.2 Images and appearance

6.4 Graph panes

6.5 Option panes

6.5.1 Option panes with images

6.6 Text input choice

6.7 Menu components

6.8 General properties of choices

6.8.1 Interaction

6.8.2 Selections

6.8.3 Callbacks

7 Laying Out CAPI Panes

7.1 Organizing panes in columns and rows

7.2 Other types of layout

7.2.1 Grid layouts

7.2.2 Simple layouts

7.2.3 Pinboard layouts

7.3 Combining different layouts

7.4 Constraining the size of layouts

7.4.1 Default Constraints

7.4.2 Width and Height Constraints

7.4.3 Constraint Formats

7.4.3.1 Character constraints

7.4.3.2 String constraints

7.4.4 Changing the constraints

7.4.4.1 Initial constraints

7.5 Advanced pane layouts

7.5.1 Switchable layouts

7.5.2 Tab layouts

7.5.3 Dividers and separators

7.5.4 Multiple-Document Interface (MDI)

8 Modifying CAPI Windows

8.1 Initialization

8.2 Resizing and positioning

8.2.1 Positioning CAPI windows

8.3 Scrolling

8.3.1 Automatic scrolling

8.4 Swapping panes and layouts

8.5 Specifying panes and layouts dynamically

8.6 Updating pane contents

8.6.1 Updating windows in real time

8.7 Iconifying and restoring windows

8.8 Closing windows

8.9 Quitting applications

9 Creating Menus

9.1 Creating a menu

9.2 Grouping menu items together

9.3 Creating individual menu items

9.4 The CAPI menu hierarchy

9.5 Mnemonics in menus

9.6 Alternative menu items

9.7 Disabling menu items

9.7.1 Dialogs and disabled menu items

9.8 Menus with images

9.9 The Edit menu on Cocoa

9.10 Popup menus for panes

9.11 The Application menu

10 Defining Interface Classes

10.1 The define-interface macro

10.2 An example interface

10.2.1 How the example works

10.3 Adapting the example

10.3.1 Adding menus

10.4 Connecting an interface to an application

10.5 Controlling the interface title

10.6 Querying and modifying interface geometry

10.6.1 Support for multiple monitors

11 Prompting for Input

11.1 Some simple dialogs

11.2 Prompting for values

11.2.1 Prompting for strings

11.2.2 Prompting for numbers

11.2.3 Prompting for an item in a list

11.2.4 Prompting for files

11.2.5 Prompting for fonts

11.2.6 Prompting for colors

11.2.7 Prompting for Lisp objects

11.3 Window-modal Cocoa dialogs

11.3.1 The :continuation argument

11.3.2 A dialog which is window-modal on Cocoa

11.4 Dialog Owners

11.4.1 The default owner

11.4.2 Specifying the owner

11.5 Creating your own dialogs

11.5.1 Using display-dialog

11.5.2 Using popup-confirmer

11.5.3 Modal and non-modal dialogs

11.6 In-place completion

11.6.1 In-place completion user interface

11.6.1.1 Invoking in-place completion in text-input-pane and editor-pane

11.6.1.2 Keyboard input handling while the in-place window is displayed

11.6.1.3 Performing a Completion

11.6.1.4 Interaction while the in-place window is displayed

11.6.2 Programmatic control of in-place completion

11.6.2.1 Text input panes

11.6.2.2 Editor panes

11.6.2.3 Other CAPI panes

12 Creating Your Own Panes

12.1 Displaying graphics

12.2 Receiving input from the user

12.3 Creating graphical objects

12.3.1 Buffered drawing

12.3.2 The implementation of graph panes

12.3.3 An example pinboard object

13 Graphics Ports

13.1 Introduction

13.1.1 Creating instances

13.2 Features

13.2.1 The drawing mode and anti-aliasing

13.3 Graphics state

13.3.1 Setting the graphics state

13.4 Drawing functions

13.4.1 Text

13.4.2 Simple lines

13.4.3 Simple shapes

13.4.4 Paths

13.5 Graphics state transforms

13.5.1 Generalized points

13.5.2 Drawing on screen

13.6 Combining source and target pixels

13.6.1 Combining pixels with :compatible drawing

13.6.2 Combining pixels with :quality drawing

13.7 Pixmap graphics ports

13.7.1 Relative drawing in pixmap graphics ports

13.8 Portable font descriptions

13.8.1 Font attributes and font descriptions

13.8.2 Fonts

13.9 Working with images

13.9.1 Image formats supported for reading from disk and drawing

13.9.2 Image formats supported for writing to disk

13.9.3 External images

13.9.3.1 Transparency

13.9.3.2 Converting an external image

13.9.4 Registering images

13.9.5 Loading images

13.9.6 Querying image dimensions

13.9.7 Drawing images

13.9.8 Image access

13.9.9 Creating external images from Graphics Ports operations

14 The Color System

14.1 Introduction

14.1.1 Rendering of colors

14.2 Reading the color database

14.3 Color specs

14.4 Color aliases

14.5 Color models

14.6 Loading the color database

14.7 Defining new color models

15 Printing from the CAPI--the Hardcopy API

15.1 Printers

15.1.1 Standard shortcut keys in printer dialogs

15.2 Printer definition files

15.3 PPD files

15.4 Print jobs

15.5 Handling pages--page on demand printing

15.6 Handling pages--page sequential printing

15.7 Printing a page

15.7.1 Establishing a page transform

15.8 Other printing functions

16 Drag and Drop

16.1 Overview of drag and drop in CAPI

16.1.1 Drag and drop with other applications

16.2 Dragging

16.2.1 Dragging values from a choice

16.2.1.1 Example: dragging from a tree

16.2.2 Dragging values from an output-pane

16.2.3 Data formats

16.2.4 Dragging a Cocoa title bar image

16.3 Dropping

16.3.1 The drop callback

16.3.2 Dropping in a choice

16.3.2.1 Example: dropping in a list

16.3.3 Dropping text in an editor-pane

16.3.4 Dropping in an output-pane

16.4 Limitations of CAPI drag and drop

Index

 


CAPI User Guide (Macintosh version) - 30 Aug 2011

NextPrevTopIndex