Page 222	Table of Contents	Index	Page 224
	Chapters
	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 A, B, C, D, E

CHAPTER 23. PRESENTATION TYPES

behavior.

=> accept-1 stream type &key view default default-type provide-default insert-default replace-input
history prompt prompt-mode display-default query-identifier activation-gestures additional-activation-
gestures delimiter-gestures additional-delimiter-gestures [Function]
Requests input of type type from the stream stream. type must be a presentation type speci-
fier. view is a view object that defaults to stream-default-view of stream. accept-1 returns
two values, the object representing the input and its presentation type. (If frame-maintain- presentation-historiesis true for the current frame, then the returned object is also pushed
on to the presentation history for that object.)

accept-1 establishes an input context via with-input-context, and then calls the acceptpresentation method for type and view. When called on an interactive stream, accept must
allow input editing; see Chapter 24 for a discussion of input editing. The call to accept will be
terminated when the accept method returns, or the user clicks on a sensitive presentation. The
typing of an activation and delimiter character is typically one way in which a call to an acceptmethod is terminated.

A top-level accept satisfied by keyboard input discards the terminating keyboard gesture (which
will be either a delimiter or an activation gesture). A nested call to accept leaves the terminating
gesture unread.

If the user clicked on a matching presentation, accept-1 will insert the object into the input
buffer by calling presentation-replace-input on the object and type returned by the presen-
tation translator, unless either the boolean replace-input is false or the presentation translator
returned an :echo option of false. replace-input defaults to true, but this default is overridden
by the translator explicitly returning an :echo option of false.

If default is supplied, then it and default-type are returned as values from accept-1 when the
input is empty. default-type must be a presentation type specifier. If default is not supplied and
provide-default is true (the default is false), then the default is determined by taking the most
recent item from the presentation type history specified by history. If insert-default is true and
there is a default, the default will be inserted into the input stream by calling presentation- replace-input.

history must be either nil, meaning that no presentation type history will be used, or a pre-
sentation type (or abbreviation) that names a history to be used for the call to accept. history
defaults to type.

prompt can be t, which prompts by describing the type, nil, which suppresses prompting, or
a string, which is displayed as a prompt (via write-string). The default is t, which produces
"Enter a type:" in a top-level call to accept or "(type)" in a nested call to accept.

If the boolean display-default is true, the default is displayed (if one was supplied). If display-
default is false, the default is not displayed. display-default defaults to true if prompt was pro-
vided, otherwise it defaults to false.

prompt-mode can be :normal (the default) or :raw, which suppresses putting a colon after the

Page 222	Table of Contents	Index	Page 224
	Chapters
	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 A, B, C, D, E