Instance Method

setDismissesAutomatically:

Sets the state of the flag that determines whether the candidates window dismisses automatically.

Declaration

- (void)setDismissesAutomatically:(BOOL)flag;

Parameters

flag

YES to have the candidates window dismiss automatically; otherwise NO.

Discussion

By default, if the user presses the Return or Enter keys, the candidates are dismissed and a candidateSelected: message is sent to the input controller. You can call the setDismissesAutomatically: method, passing NO as the flag parameter to change the default dismissal behavior. The input controller still receives a candidatesSelected: message.

When you set the flag to NO, an input method processes text input while dynamically updating the content of the candidates as the user inputs text. When a session deactivates, candidate window is hidden regardless of the state of the flag.

See Also

Managing Window Visibility and Behavior

- show:

Shows the candidates window.

- hide

Hides a candidates window, if it is visible.

- isVisible

Returns whether or not the candidates window is visible.

- dismissesAutomatically

Returns the state of the flag that determines whether the candidates window dismisses automatically.

- updateCandidates

Updates the candidates that are displayed in the candidates window.