SCWSingleCharWidgetDelegate Protocol Reference
Conforms to | NSObject |
Declared in | SCWSingleCharWidgetDelegate.h |
Tasks
-
– singleCharWidget:didChangeText:intermediate:
-
– singleCharWidget:didDetectSingleTapAtPoint:
-
– singleCharWidget:didDetectLongPressAtPoint:
-
– singleCharWidget:didDetectBackspaceAtIndex:withCount:
-
– singleCharWidget:didDetectReturnAtIndex:
-
– singleCharWidget:didConfigureWithSuccess:
-
– singleCharWidgetPenDown:didCaptureInfo:
-
– singleCharWidgetPenUp:didCaptureInfo:
-
– singleCharWidgetPenMove:didCaptureInfo:
-
– singleCharWidgetPenAbort:
Instance Methods
singleCharWidget:didChangeText:intermediate:
Called when the text changes. The text returned by this callback may be intermediate, which means that it can change again in the near future. Text is intermediate as long as the widget has some ink that has not been processed yet.
- (void)singleCharWidget:(SCWSingleCharWidget *)sender didChangeText:(NSString *)text intermediate:(BOOL)intermediate
Parameters
- sender
Widget for which text changes.
- text
String representation of the text.
- intermediate
YES
if the text is an intermediate handwriting recognition result,NO
if the text is stable.
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidget:didConfigureWithSuccess:
Called when handwriting configuration ends. In case of failure, you may retrieve more information by calling either [SCWSingleCharWidget errorCode] or [SCWSingleCharWidget errorString].
- (void)singleCharWidget:(SCWSingleCharWidget *)sender didConfigureWithSuccess:(BOOL)success
Parameters
- sender
Widget for which configuration is done.
- success
YES
if configuration succeeded,NO
otherwise.
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidget:didDetectBackspaceAtIndex:withCount:
Called when a backspace gesture is detected.
- (void)singleCharWidget:(SCWSingleCharWidget *)sender didDetectBackspaceAtIndex:(NSUInteger)index withCount:(NSUInteger)count
Parameters
- sender
Widget that has detected the gesture.
- index
Character index at which gesture is detected.
- count
Number of consecutive detected backspace gestures.
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidget:didDetectLongPressAtPoint:
Called when a long press gesture is detected.
The application may choose to take action when a long press
gesture is detected, in this case this callback shall return
YES
to indicate that it handled the event and the
current stroke is cancelled.
If this callback returns NO
, then the long
press gesture is discarded by the widget and the widget resumes
the capture of the current stroke.
This callback is called from a native thread, not from the UI thread. You must not call any widget methods from this callback, or the widget will enter a deadlock state.
- (BOOL)singleCharWidget:(SCWSingleCharWidget *)sender didDetectLongPressAtPoint:(CGPoint)point
Parameters
- sender
Widget that has detected the gesture.
- point
CGPoint position of the single tap in widget coordinates.
Return Value
YES
if long press event is handled,
NO
otherwise.
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidget:didDetectReturnAtIndex:
Called when a return gesture is detected.
- (void)singleCharWidget:(SCWSingleCharWidget *)sender didDetectReturnAtIndex:(NSUInteger)index
Parameters
- sender
Widget that has detected the gesture.
- index
Character index at which gesture is detected.
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidget:didDetectSingleTapAtPoint:
Called when a single tap gesture is detected.
The application may choose to take action when a single tap
gesture is detected, in this case this callback shall return
YES
to indicate that it handled the event.
If this callback returns NO
, then the single
tap gesture is considered by the widget as a genuine dot and
passed to the handwriting recognizer.
This callback is called from a native thread, not from the UI thread. You must not call any widget methods from this callback, or the widget will enter a deadlock state.
- (BOOL)singleCharWidget:(SCWSingleCharWidget *)sender didDetectSingleTapAtPoint:(CGPoint)point
Parameters
- sender
Widget that has detected the gesture.
- point
CGPoint position of the single tap in widget coordinates.
Return Value
YES
if single tap event is handled,
NO
otherwise (indicates a handwritten dot).
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidgetPenAbort:
Called when the user aborts writing.
- (void)singleCharWidgetPenAbort:(SCWSingleCharWidget *)sender
Parameters
- sender
Widget for which user aborts writing.
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidgetPenDown:didCaptureInfo:
Called when the user starts writing.
- (void)singleCharWidgetPenDown:(SCWSingleCharWidget *)sender didCaptureInfo:(IMCaptureInfo *)captureInfo
Parameters
- sender
Widget for which user starts writing.
- captureInfo
Coordinates and other information about touch sample.
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidgetPenMove:didCaptureInfo:
Called when the user is writing.
- (void)singleCharWidgetPenMove:(SCWSingleCharWidget *)sender didCaptureInfo:(IMCaptureInfo *)captureInfo
Parameters
- sender
Widget for which user is writing.
- captureInfo
Coordinates and other information about touch sample.
Declared In
SCWSingleCharWidgetDelegate.h
singleCharWidgetPenUp:didCaptureInfo:
Called when the user ends writing.
- (void)singleCharWidgetPenUp:(SCWSingleCharWidget *)sender didCaptureInfo:(IMCaptureInfo *)captureInfo
Parameters
- sender
Widget for which user ends writing.
- captureInfo
Coordinates and other information about touch sample.
Declared In
SCWSingleCharWidgetDelegate.h