keyboard_virtual_show()


Game Maker Language リファレンス > 組み込み関数 用途別 > ユーザインターフェース > keyboard_virtual_show()

keyboard_virtual_show()

この関数を使用すると、ゲームを実行しているデバイスの仮想キーボードを表示できます。 この関数を呼び出すときは、最初の3つの引数のそれぞれに次の定数のいずれかを指定する必要があります。

1. Keyboard type
この定数は、仮想キーボードで使用できるキーセットを設定するために使用されます。 使用可能なキーボードの種類は次のとおりです。
Keyboard TypeDescription
kbv_type_default現在のシステムのデフォルトのキーボードタイプ
kbv_type_asciiASCII文字のみのキーボード
kbv_type_urlURL入力用に最適化された通常のキーボード。 通常、".com" または他のドメインキー、および "/" と"." キーを備えています
kbv_type_email電子メール入力用に最適化された通常のキーボード。 通常は "@" と "." の文字を使用します
kbv_type_numbers数字専用キーボード。通常はテンキーとして表示されます
kbv_type_phone電話パッドキーボード。 通常は数字、"*" キーと "#" キーのみです
kbv_type_phone_name電話番号と名前の両方を入力するために最適化されたキーボード。 通常はASCIIキーボードに似ていますが、特殊文字の選択が制限されています
2. Return type
この定数は、仮想キーボードのリターン/アクションキーに表示される内容を設定するために使用されます。 利用可能な返品タイプは次のとおりです
Return TypeDescription
kbv_returnkey_default現在のシステムのデフォルトのリターンキータイトル
kbv_returnkey_goリターンキーのタイトルを "Go" に設定します
kbv_returnkey_googleリターンキーのタイトルを "Google" に設定するか、場合によっては一般的な検索アイコンに設定します
kbv_returnkey_joinリターンキーのタイトルを "Join" に設定します
kbv_returnkey_nextリターンキーのタイトルを "Next" に設定します
kbv_returnkey_routeリターンキーのタイトルを "Route" に設定します
kbv_returnkey_searchリターンキーのタイトルを"Search" に設定するか、場合によっては一般的な検索アイコンに設定します
kbv_returnkey_sendリターンキーのタイトルを "Send" に設定します
kbv_returnkey_yahooリターンキーのタイトルを"Yahoo" に設定するか、場合によっては一般的な検索アイコンに設定します
kbv_returnkey_doneリターンキーのタイトルを "Done" に設定します
kbv_returnkey_continueリターンキーのタイトルを "Continue" に設定します
kbv_returnkey_emergencyリターンキーのタイトルを "Emergency Call" に設定します
3. Autocapitalization type
この定数は、仮想キーボードを介して入力された単語を自動大文字化する方法を決定するために使用されます。 使用可能な自動資本化タイプは次のとおりです
Autocapitalization TypeDescription
kbv_autocapitalize_none自動大文字化を無効
kbv_autocapitalize_words単語で自動大文字化する
kbv_autocapitalize_sentences文節で自動大文字化する
kbv_autocapitalize_charactersすべての文字で自動大文字化する

最後の引数は予測テキストを有効/無効にすることであり、これは許可する場合はtrueに設定され、それ以外の場合はfalseに設定されますが、許可されているからといって、設定に応じて使用されるわけではないことに注意してください。 デバイス上のユーザーの。 予測テキストモードの場合、仮想キーボードは通常のGameMaker Studio2キー押下イベントを生成しません。 代わりに、最後に押された文字とキーボードの文字列変数のみが更新されます。 これは、キーの押下を検出するために使用される内部テキストフィールドの変更が、実際の仮想キーボードキーによるものなのか、テキストの提案によるものなのかを検出できないためです。 このような場合、生のキー入力を読み取るのではなく、keyboard_string入力を読み取る必要があります。

プラットフォームOSに応じて、ユーザーはさまざまな機能を備えたさまざまなキーボードを入手することに注意することも重要です。ターゲットごとに使用する場合は、次の注意事項があります。

  • UWP:UWP実装は、"return_key_type"、"autocapitalization_type"、または "predictive_text_enabled" をサポートしていません。 これらのパラメータを関数に渡してもエラーは発生せず、キーボードに影響を与えることはありません
  • Android / Amazon Fire:Androidでは、キーボードタイプ "kbv_type_phone_name" はサポートされておらず、代わりにASCIIキーボードが表示されます。リターンキータイプは、"kbv_returnkey_go"、"kbv_returnkey_search"、"kbv_returnkey_next"、"kbv_returnkey_send"、または "kbv_returnkey_done" のみです。 そのプラットフォームで他のリターンキータイプが使用されている場合、システムはデフォルトで以下にリストされている交換用リターンキーになります
    使用できない リターンキー置き換えするキー
    kbv_returnkey_googlekbv_returnkey_search
    kbv_returnkey_yahookbv_returnkey_search
    kbv_returnkey_joinkbv_returnkey_go
    kbv_returnkey_routekbv_returnkey_go
    kbv_returnkey_emergencykbv_returnkey_go
    kbv_returnkey_continuekbv_returnkey_next
  • AndroidTV / FireTV:カスタムリターンキータイプはASCIIキーボードではサポートされていません。デフォルトのリターンキーが常に表示されます
  • tvOS:予測テキストと自動大文字化はtvOSでサポートされておらず、システムイベントと関数 keyboard_virtual_height() によって返されるキーボードの高さは、画面全体に広がり、キーボードの四角形の寸法関数が無効になっているため、デフォルトで画面の高さになります。 tvOSで。 また、仮想キーボードが開かれていない限り、物理(Bluetooth)キーボードイベントはブロードキャストされないことに注意してください

この関数を呼び出すと、システム非同期イベントが生成されます。このイベントでは、async_load DS_Mapに次のキーと値のペアが入力されます

  • event_type:これは、仮想キーボード機能によってトリガーされると "仮想キーボードステータス" になります
  • screen_height:仮想キーボードの高さ(ピクセル単位)。 キーボードが表示されていない場合、これは0になります
  • keyboard_status:キーボードの現在のステータス。次の文字列のいずれかとして返されます
    • "hiding"
    • "hidden"
    • "showing"
    • "visible"

構文

keyboard_virtual_show(keyboard_type, return_key_type, autocapitalization_type, predictive_text_enabled);
keyboard_type
仮想キーボードで使用可能なキーセットを決定します
return_key_type
仮想キーボードのリターン/アクションキーに何を表示するかを決定します
autocapitalization_type
仮想キーボードを介して入力された単語を自動大文字化する方法/かどうかを決定します
predictive_text_enabled
予測テキスト入力を有効/無効にするには、true / falseに設定します

戻り値

N/A
なし

if input == false
{
   input = true;
   keyboard_virtual_show(kbv_type_numbers, kbv_returnkey_default, kbv_autocapitalize_none, false);
}

上記のコードは、指定された変数がtrueに設定されていない場合、OS仮想キーボードを起動します。

Wiki内検索

#search(): You already view a search box

MENU

ドキュメント

GMLリファレンス

2ch

その他



最新の30件

2021-01-23 2021-01-22 2021-01-21 2021-01-19 2021-01-18 2021-01-17 2021-01-16 2021-01-15 2021-01-14 2021-01-13

人気の10件

今日の10件



これまでの訪問者: 104
今日の訪問者: 1
昨日の訪問者: 0
閲覧者: 5