元のドキュメント： developer.apple.com/documentation/watchkit/wkinterfacecontroller/presenttextinputcontroller(
withsuggestions:allowedinputmode:completion:)

インスタンスメソッド

presentTextInputController(with
Suggestions:allowedInputMode:completion:)

ユーザーからテキスト入力を受け付けるためのモーダルインターフェースを表示します。

func presentTextInputController(
    withSuggestions suggestions: [String]?,
    allowedInputMode inputMode: WKTextInputMode,
    completion: @escaping ([Any]?) -> Void
)

func presentTextInputController(
    withSuggestions suggestions: [String]?,
    allowedInputMode inputMode: WKTextInputMode
) async -> [Any]?

パラメータ

suggestions

NSString オブジェクトの配列。各オブジェクトには、入力候補となるフレーズが含まれています。ユーザーは、提示されたフレーズのいずれかを選択することも、新しいテキストフレーズを入力することもできます。

inputMode

許可する入力のタイプ。指定可能な値のリストについては、WKTextInputMode を参照してください。

completion

ユーザーがモーダルインターフェースを閉じた後に実行されるブロックです。このブロックは戻り値を返さず、以下のパラメータを受け取ります。

results

ユーザーからの入力を含んでいる配列、またはユーザーが操作をキャンセルした場合は nil。配列が提供される場合、その配列内の値は通常、入力されたテキストを表す NSString オブジェクトです。配列には、NSData オブジェクトとしてパッケージ化された絵文字画像が含まれることもあります。このデータオブジェクトを使用して、対応する UIImage オブジェクトを作成できます。

以下で言及

シーン間の移動

議論

このメソッドは非同期的に実行され、呼び出した後すぐに戻ります。その後のランループサイクルで、システムはユーザーにテキスト入力コントローラを表示します。この入力コントローラには、あなたが指定した入力フレーズのリストが表示されるほか、音声入力による新しいテキストフレーズの入力や、絵文字リストからの選択を行うためのオプションも用意されています。

ユーザーが値を受け入れるかまたは入力をキャンセルすると、テキスト入力コントローラーは自身を閉じ、WatchKit 拡張機能のメインスレッド上で completion パラメータに指定されたブロックを実行します。このブロックを使用して、受け入れた値を取得し、コンテンツに適用します。ブロックの実行前に、現在のインターフェイスコントローラーがアクティブになります。

このメソッドは、必ず WatchKit 拡張機能のメインスレッドから呼び出してください。

以下も見よ

テキスト入力の処理

func presentTextInputControllerWithSuggestions(forLanguage: ((String) -> [Any]?)?, allowedInputMode: WKTextInputMode, completion: ([Any]?) -> Void)

ユーザーから言語固有のテキスト入力を収集するためのモーダルインターフェースを表示します。

func dismissTextInputController()

テキストを返さずに、テキスト入力コントローラーを閉じます。

enum WKTextInputMode

テキスト入力コントローラーによってサポートされる入力モード。