KeyEvent クラス

リファレンス

定義

名前空間:: Android.Views

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

キーイベントとボタンイベントを報告するために使用されるオブジェクト。

[Android.Runtime.Register("android/view/KeyEvent", DoNotGenerateAcw=true)]
public class KeyEvent : Android.Views.InputEvent, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/view/KeyEvent", DoNotGenerateAcw=true)>]
type KeyEvent = class
    inherit InputEvent
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

継承: Object

Object

InputEvent
KeyEvent

属性: RegisterAttribute

実装: IParcelable IJavaObject IJavaPeerable IDisposable

注釈

キーイベントとボタンイベントを報告するために使用されるオブジェクト。

各キー押下は、一連のキーイベントによって記述されます。キーの押しは、のキーイベントで #ACTION_DOWN始まります。キーが繰り返されるのに十分な長さがある場合、最初のダウンの後に、との 0 以外の値#getRepeatCount()を持つ#ACTION_DOWN追加のキーイベントが続きます。最後のキーイベントは、 #ACTION_UP キーアップのです。キーの押しが取り消された場合、キーアップイベントにはフラグが #FLAG_CANCELED 設定されます。

キーイベントには、通常、キーコード ()、スキャンコード (#getKeyCode()#getScanCode())、メタ状態 (#getMetaState()) が伴います。キーコード定数は、このクラスで定義されます。スキャンコード定数は、OS から取得された未加工のデバイス固有のコードであるため、を使用して KeyCharacterMap解釈されない限り、通常はアプリケーションにとって意味がありません。メタ状態は、や #META_ALT_ONなどの#META_SHIFT_ONキー修飾子の押された状態を表します。

通常、キーコードは、入力デバイス上の個々のキーと 1 対 1 で対応します。多くのキーとキーの組み合わせは、異なる入力デバイスでまったく異なる機能を提供するため、それらを解釈するときは注意が必要です。キーを文字に KeyCharacterMap マッピングするときは、常に入力デバイスに関連付けられているを使用します。同時に複数のキー入力デバイスがアクティブになる可能性があり、それぞれに独自のキー文字マップがあることに注意してください。

ソフト入力方法ではテキストを入力する複数の発明的な方法を使用できるため、ソフトキーボードを押すとキーイベントが生成される保証はありません。これは IME の裁量に委ねられ、実際にはそのようなイベントを送信することはお勧めしません。ソフト入力メソッドのキーに対して KeyEvents を受け取る必要はありません。特に、既定のソフトウェアキーボードは、Jelly Bean 以降を対象とするアプリケーションにキーイベントを送信することはありません。また、削除の一部の押下に対してのみイベントを送信し、Ice Cream Sandwich 以前を対象とするアプリケーションにキーを返します。他のソフトウェア入力方法では、バージョンに関係なくキーイベントが送信されないことがあることに注意してください。ソフトウェアキーボードとの特定の操作が必要な場合など android.view.inputmethod.EditorInfo#IME_ACTION_DONE 、エディターアクションを使用することを検討してください。これにより、アプリケーションがキー押しに対してどのように反応するかについて、ユーザーに対してより多くの可視性が与えられます。

IME と対話する場合、フレームワークは、単一の繰り返しキーコードまたは挿入する一連の文字を指定する特別なアクション #ACTION_MULTIPLE を使用して、キーイベントを配信できます。

一般に、フレームワークでは、ビューに配信されるキーイベントが常に完全なキーシーケンスを構成することを保証できません。一部のイベントは、配信前にビューを含めることで削除または変更される可能性があるためです。ビューの実装は、処理 #FLAG_CANCELED できるように準備する必要があり、前のキー押しのを最初に受け取らずに新しい #ACTION_DOWN を受け取る #ACTION_UP などの異常な状況を許容する必要があります。

InputDeviceさまざまな種類の入力デバイスとソースがキーとボタンを表す方法の詳細については、を参照してください。

の Java ドキュメント android.view.KeyEvent。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32)	新しいキーイベントを作成します。
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates)	新しいキーイベントを作成します。
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32)	新しいキーイベントを作成します。
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32, KeyEventFlags)	新しいキーイベントを作成します。
KeyEvent(Int64, Int64, KeyEventActions, Keycode, Int32, MetaKeyStates, Int32, Int32, KeyEventFlags, InputSourceType)	新しいキーイベントを作成します。
KeyEvent(Int64, String, Int32, KeyEventFlags)	文字列の新しいキーイベントを作成します。
KeyEvent(IntPtr, JniHandleOwnership)	JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。
KeyEvent(KeyEvent)	既存のキーイベントの正確なコピーを作成します。
KeyEvent(KeyEvent, Int64, Int32)	古い. 既存のキーイベントをコピーし、時間と繰り返し数を変更します。
KeyEvent(KeyEventActions, Keycode)	新しいキーイベントを作成します。

フィールド

KeycodeDemoApp1	古い. キーコード定数: デモアプリケーションキー #1。
KeycodeDemoApp2	古い. キーコード定数: デモアプリケーションキー #2。
KeycodeDemoApp3	古い. キーコード定数: デモアプリケーションキー #3。
KeycodeDemoApp4	古い. キーコード定数: デモアプリケーションキー #4。
KeycodeFeaturedApp1	古い. キーコード定数: おすすめアプリケーションキー #1。
KeycodeFeaturedApp2	古い. キーコード定数: おすすめアプリケーションキー #2。
KeycodeFeaturedApp3	古い. キーコード定数: おすすめアプリケーションキー #3。
KeycodeFeaturedApp4	古い. キーコード定数: おすすめアプリケーションキー #4。
KeycodeKeyboardBacklightDown	古い. キーコード定数: キーボードバックライトダウン
KeycodeKeyboardBacklightToggle	古い. キーコード定数: キーボードバックライトトグル
KeycodeKeyboardBacklightUp	古い. キーコード定数: キーボードバックライトアップ
KeycodeMacro1	古い. キーコード定数: システムを通じてユーザーが使用をカスタマイズできるボタン。
KeycodeMacro2	古い. キーコード定数: システムを通じてユーザーが使用をカスタマイズできるボタン。
KeycodeMacro3	古い. キーコード定数: システムを通じてユーザーが使用をカスタマイズできるボタン。
KeycodeMacro4	古い. キーコード定数: システムを通じてユーザーが使用をカスタマイズできるボタン。
KeycodeRecentApps	古い. キーコード定数: 最近使用したアプリビューを開くには (a.
KeycodeStylusButtonPrimary	古い. キーコード定数: スタイラスのバレルの主ボタン。
KeycodeStylusButtonSecondary	古い. キーコード定数: スタイラスのバレルのセカンダリボタン。
KeycodeStylusButtonTail	古い. キーコード定数: スタイラスの末尾にあるボタン。
KeycodeStylusButtonTertiary	古い. キーコード定数: スタイラスのバレルの 3 次ボタン。
KeycodeVideoApp1	古い. キーコード定数: ビデオアプリケーションキー #1。
KeycodeVideoApp2	古い. キーコード定数: ビデオアプリケーションキー #2。
KeycodeVideoApp3	古い. キーコード定数: ビデオアプリケーションキー #3。
KeycodeVideoApp4	古い. キーコード定数: ビデオアプリケーションキー #4。
KeycodeVideoApp5	古い. キーコード定数: ビデオアプリケーションキー #5。
KeycodeVideoApp6	古い. キーコード定数: ビデオアプリケーションキー #6。
KeycodeVideoApp7	古い. キーコード定数: ビデオアプリケーションキー #7。
KeycodeVideoApp8	古い. キーコード定数: ビデオアプリケーションキー #8。
MaxKeycode	古い. このメンバーは非推奨とされます。

プロパティ

Action	このキーイベントのアクションを取得します。
Characters	キーコード `#KEYCODE_UNKNOWN`がのイベントの`#ACTION_MULTIPLE`特殊なケースの場合、これはイベントに関連付けられた文字の生文字列です。
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Creator
Device	このイベントの発生元のデバイスを取得します。 (継承元 InputEvent)
DeviceId	追加する
DisplayLabel	このキーの主文字を取得します。
DownTime	最新のキーダウンイベントの時刻を `android.os.SystemClock#uptimeMillis` 時間ベースで取得します。
EventTime	このイベントが発生した時刻を `android.os.SystemClock#uptimeMillis` 時間ベースで取得します。
Flags	このキーイベントのフラグを返します。
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
HasNoModifiers	修飾子キーが押されていない場合は true を返します。
IsAltPressed	Alt メタキーの押された状態を返します。
IsCanceled	イベントの場合 `#ACTION_UP` 、は、に従ってイベントが取り消されたことを示します `#FLAG_CANCELED`。
IsCapsLockOn	CAPS LOCK メタキーのロック状態を返します。
IsCtrlPressed	Ctrl メタキーの押された状態を返します。
IsFunctionPressed	FUNCTION メタキーの押された状態を返します。
IsLongPress	イベントの場合 `#ACTION_DOWN` 、は、に従ってイベントが取り消されたことを示します `#FLAG_LONG_PRESS`。
IsMetaPressed	META メタキーの押された状態を返します。
IsNumLockOn	NUM LOCK メタキーのロック状態を返します。
IsPrintingKey	このキーがグリフを生成する場合は true を返します。
IsScrollLockOn	SCROLL LOCK メタキーのロック状態を返します。
IsShiftPressed	Shift メタキーの押された状態を返します。
IsSymPressed	SYM メタキーの押された状態を返します。
IsSystem	これはシステムキーですか? システムキーは、メニューショートカットには使用できません。
IsTracking	イベントの場合 `#ACTION_UP` 、は、に従ってイベントが最初のダウンイベントから追跡されていることを示します `#FLAG_TRACKING`。
JniIdentityHashCode	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
JniPeerMembers	キーイベントとボタンイベントを報告するために使用されるオブジェクト。
KeyCharacterMap	キーボードデバイスに `KeyCharacterMap` 関連付けられているを取得します。
KeyCode	キーイベントのキーコードを取得します。
MaxKeyCode	最大キーコードを返します。
MetaState	メタキーの状態を返します。
ModifierMetaStateMask	有効なすべての修飾子キーメタ状態ビットを含むマスクを取得します。
Modifiers	修飾子キーの状態を返します。
Number	キーに関連付けられている数値または記号を取得します。
PeerReference	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
RepeatCount	イベントの繰り返し数を取得します。
ScanCode	このキーイベントのハードウェアキー ID を取得します。
Source	追加する
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。
UnicodeChar	指定したキーとメタキーの状態の組み合わせによって生成された Unicode 文字を取得します。

メソッド

ChangeAction(KeyEvent, KeyEventActions)	指定したキーイベントと同じで、アクションが指定された値に置き換えられる新しいキーイベントを作成します。
ChangeFlags(KeyEvent, KeyEventFlags)	指定したキーイベントと同じで、フラグが指定された値に置き換えられる新しいキーイベントを作成します。
ChangeTimeRepeat(KeyEvent, Int64, Int32)	指定したキーイベントと同じで、イベント時間と繰り返し数が指定された値に置き換えられる新しいキーイベントを作成します。
ChangeTimeRepeat(KeyEvent, Int64, Int32, KeyEventFlags)	指定したキーイベントと同じで、イベント時間と繰り返し数が指定された値に置き換えられる新しいキーイベントを作成します。
Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
DescribeContents()	この Parcelable のマーシャリング表現に含まれる特殊なオブジェクトの種類について説明します。 (継承元 InputEvent)
Dispatch(KeyEvent+ICallback)
Dispatch(KeyEvent+ICallback, KeyEvent+DispatcherState, Object)	このキーイベントをコールバックインターフェイスに配信します。
Dispose()	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
Dispose(Boolean)	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
GetDeadChar(Int32, Int32)	文字 c にアクセントを付けることで生成される文字を取得します。
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
GetKeyData(KeyCharacterMap+KeyData)	古い. 特定のキーコードの文字変換データを取得します。
GetMatch(Char[])	指定したキーコードによって生成できる文字配列の最初の文字を取得します。
GetMatch(Char[], Int32)	古い. キーイベントとボタンイベントを報告するために使用されるオブジェクト。
GetMatch(Char[], MetaKeyStates)	指定したキーコードによって生成できる文字配列の最初の文字を取得します。
GetUnicodeChar(Int32)	古い. キーイベントとボタンイベントを報告するために使用されるオブジェクト。
GetUnicodeChar(MetaKeyStates)	指定したキーとメタキーの状態の組み合わせによって生成された Unicode 文字を取得します。
HasModifiers(MetaKeyStates)	指定した修飾子キーのみが押された場合は true を返します。
IsFromSource(InputSourceType)	イベントが指定されたソースからのものかどうかを判断します。 (継承元 InputEvent)
IsGamepadButton(Keycode)	指定したキーコードがゲームパッドボタンの場合は true を返します。
IsMediaSessionKey(Int32)	このキーが処理されない場合にに `android.media.session.MediaSession.Callback` 送信されるかどうかを返します。
IsModifierKey(Keycode)	このキーコードが修飾子キーの場合は true を返します。
JavaFinalize()	ガベージコレクションがオブジェクトへの参照がなくなったと判断したときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
KeyCodeFromString(String)	"KEYCODE_A" などのシンボリック名または "29" などの同等の数値定数でキーコードを取得します。
KeyCodeToString(Keycode)	指定したキーコードのシンボル名 ("KEYCODE_A"、"KEYCODE_DPAD_UP"、不明な場合は "1001" などの同等の数値定数を表す文字列を返します。
MetaStateHasModifiers(MetaKeyStates, MetaKeyStates)	指定したメタ状態に従って指定した修飾子キーのみが押された場合は true を返します。
MetaStateHasNoModifiers(MetaKeyStates)	指定したメタ状態に従って修飾子キーが押されない場合は true を返します。
NormalizeMetaState(MetaKeyStates)	指定したメタ状態を正規化します。
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドをウェイクアップします。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドをウェイクアップします。 (継承元 Object)
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetSource(InputSourceType)	追加する
StartTracking()	この呼び出しは、システムが最後のアップ (長押しを含む) を通じてキーを追跡するために呼 `Callback#onKeyDown` び出します。
ToArray<T>()	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
Wait()	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または <em>割り込み</em によって待機します>。 (継承元 Object)
Wait(Int64)	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	このオブジェクトをパーセルにフラット化します。

明示的なインターフェイスの実装

IJavaPeerable.Disposed()	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
IJavaPeerable.Finalized()	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
IJavaPeerable.JniManagedPeerState	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	キーイベントとボタンイベントを報告するために使用されるオブジェクト。 (継承元 Object)

拡張メソッド

JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	キーイベントとボタンイベントを報告するために使用されるオブジェクト。
GetJniTypeName(IJavaPeerable)	キーイベントとボタンイベントを報告するために使用されるオブジェクト。

適用対象