24.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. [annotate]

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

*activation-gestures*   [Variable]
          

The set of currently active activation gestures. The global value of this must be nil. The exact format of *activation-gestures* is unspecified. *activation-gestures* and the elements in it may have dynamic extent. [annotate]

[annotate]

*standard-activation-gestures*   [Variable]
          

The default set of activation gestures. The exact set of standard activation is unspecified, but must include the gesture that corresponds to the #\Newline character. [annotate]

[annotate]

with-activation-gestures  (gestures &key override) &body body [Macro]
          

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. [annotate]

If the boolean override is true, then gestures will override the current activation gestures. If it is false (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. [annotate]

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

[annotate]

activation-gesture-p  gesture [Function]
          

Returns true if the gesture object gesture is an activation gesture, otherwise returns false. [annotate]

[annotate]

Note: This specification does not say what happens if the argument is not a gesture object at all. I interpret this specification the same way I interpret a CLHS entry, i.e., the consequences are undefined if the argument is not a gesture object. [edit]-- Robert Strandh 2014-10-07 02:59Z
 

*delimiter-gestures*   [Variable]
          

The set of currently active delimiter gestures. The global value of this must be nil. The exact format of *delimiter-gestures* is unspecified. *delimiter-gestures* and the elements in it may have dynamic extent. [annotate]

[annotate]

with-delimiter-gestures  (gestures &key override) &body body [Macro]
          

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. [annotate]

If the boolean override is true, then gestures will override the current delimiter gestures. If it is false (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. [annotate]

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

[annotate]

delimiter-gesture-p  gesture [Function]
          

Returns true if the gesture object gesture is a delimiter gesture, otherwise returns false. [annotate]

[annotate]