EnableGestureSetHRC
2.0
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
See Also