All Manuals > CLIM 2.0 User Guide > 16 Input Editing and Completion Facilities

16.2 Activation and Delimiter Gestures

Activation gestures terminate an input "sentence," such as a command or anything else being read by accept. When an activation gesture is entered by the user, CLIM will cease reading input and "execute" the input that has been entered.

Delimiter gestures terminate an input "word," such as a recursive call to accept.

*activation-gestures* Variable

Summary: The set of currently active activation gestures. The global value of this is nil. The exact format of *activation-gestures* is unspecified. *activation-gestures* and the elements in it may have dynamic extent.

*standard-activation-gestures* Variable

Summary: The default set of activation gestures. The exact set of standard activation is unspecified; it includes the gesture corresponding to the #\Newline character.

with-activation-gestures Macro

with-activation-gestures (gestures &key override) &body body

Summary: Specifies a list of gestures that terminate input during the execution of body. body may have zero or more declarations as its first forms. gestures must be either a single gesture name or a form that evaluates to a list of gesture names.

If the boolean override is t, then gestures will override the current activation gestures. If it is nil (the default), then gestures will be added to the existing set of activation gestures. with-activation-gestures must bind *activation-gestures* to the new set of activation gestures.

See also the :activation-gestures and :additional-activation-gestures options to accept.

activation-gesture-p Function

activation-gesture-p gesture

Summary: Returns t if the gesture object gesture is an activation gesture; otherwise, it returns nil.

*delimiter-gestures* Variable

Summary: The set of currently active delimiter gestures. The global value of this is nil. The exact format of *delimiter-gestures* is unspecified. *delimiter-gestures* and the elements in it may have dynamic extent.

with-delimiter-gestures Macro

with-delimiter-gestures (gestures &key override) &body body

Summary: Specifies a list of gestures that terminate an individual token, but not the entire input, during the execution of body. body may have zero or more declarations as its first forms. gestures must be either a single gesture name or a form that evaluates to a list of gesture names.

If the boolean override is t, then gestures will override the current delimiter gestures. If it is nil (the default), then gestures will be added to the existing set of delimiter gestures. with-delimiter-gestures must bind *delimiter-gestures* to the new set of delimiter gestures.

See also the :delimiter-gestures and :additional-delimiter-gestures options to accept.

delimiter-gesture-p Function

delimiter-gesture-p gesture

Summary: Returns t if the gesture object gesture is a delimiter gesture; otherwise, it returns nil.


CLIM 2.0 User Guide - 01 Dec 2021 19:39:00