EnableGestureSetHRC

Enables or disables recognition of specific gestures or collections of gestures in an HRC object.

int EnableGestureSetHRC( HRC hrc, SYV syv, BOOL fEnable )

Parameters
hrc

Handle to the HRC object.

syv

Either a gesture SYV_ symbol value, such as SYV_COPY, or one or more of the following GST_ constants combined using the bitwise-OR operator. Note that individual SYV_ gesture symbol values cannot be combined with GST_ constants.

Constant	Description
GST_SEL	Selection and lasso.
GST_CLIP	Cut, copy, paste.
GST_WHITE	Space, tab, return.
GST_EDIT	Insert, correct, undo.
GST_CIRCLELO	Lowercase circle gestures.
GST_CIRCLEUP	Uppercase circle gestures.
GST_CIRCLE	All circle gestures.
GST_ALL	All gestures.

fEnable

Enable recognition flag. This flag must be set to TRUE to enable recognition of the gesture or gestures in syv, or to FALSE to disable recognition of the specified gestures.

Return Value
Returns HRCR_OK if successful; otherwise, returns one of the following negative values:

Constant	Description
HRCR_ERROR	Invalid parameter or other error.
HRCR_MEMERR	Insufficient memory.
HRCR_UNSUPPORTED	The recognizer does not support this function.

Comments
The results of EnableGestureSetHRC are cumulative. The function can be called several times in succession to refine the precise gesture set required. However, calling EnableGestureSetHRC with syv set to GST_ALL and fEnable set to FALSE disables all gestures.

By default, a recognition context HRC enables all gestures that its associated recognizer supports.

Example
The following example enables selection, Clipboard functions, and SYV_CIRCLEUPA:

EnableGestureSetHRC( hrc, GST_ALL, FALSE ); // Disable all

EnableGestureSetHRC( hrc, GST_SEL | GST_CLIP, TRUE ); // Enable sets

EnableGestureSetHRC( hrc, SYV_CIRCLEUPA, TRUE ); // Enable circle A