Android - Event Handling

2021-12-07 14:05 Android开发

<blockquote > Events are a useful way to collect data about a user's interaction with interactive components of Applications.Like button presses or screen touch etc. The Android framework maintains an event queue as first-in, first-out (FIFO) basis. You can capture these events in your program and take appropriate action as per requirements. </blockquote> There are following three concepts related to Android Event Management − <ul class="list" > <li > Event Listeners− An event listener is an interface in the View class that contains a single callback method. These methods will be called by the Android framework when the View to which the listener has been registered is triggered by user interaction with the item in the UI. </li> <li > Event Listeners Registration− Event Registration is the process by which an Event Handler gets registered with an Event Listener so that the handler is called when the Event Listener fires the event. </li> <li > Event Handlers− When an event happens and we have registered an event listener for the event, the event listener calls the Event Handlers, which is the method that actually handles the event. </li> </ul> <h2 >Event Listeners & Event Handlers</h2> <table class="table table-bordered" > <tbody > <tr > <th >Event Handler</th> <th >Event Listener & Description</th> </tr> <tr > <td >onClick()</td> <td >OnClickListener() This is called when the user either clicks or touches or focuses upon any widget like button, text, image etc. You will use onClick() event handler to handle such event. </td> </tr> <tr > <td >onLongClick()</td> <td >OnLongClickListener() This is called when the user either clicks or touches or focuses upon any widget like button, text, image etc. for one or more seconds. You will use onLongClick() event handler to handle such event. </td> </tr> <tr > <td >onFocusChange()</td> <td >OnFocusChangeListener() This is called when the widget looses its focus ie. user goes away from the view item. You will use onFocusChange() event handler to handle such event. </td> </tr> <tr > <td >onKey()</td> <td >OnFocusChangeListener() This is called when the user is focused on the item and presses or releases a hardware key on the device. You will use onKey() event handler to handle such event. </td> </tr> <tr > <td >onTouch()</td> <td >OnTouchListener() This is called when the user presses the key, releases the key, or any movement gesture on the screen. You will use onTouch() event handler to handle such event. </td> </tr> <tr > <td >onMenuItemClick()</td> <td >OnMenuItemClickListener() This is called when the user selects a menu item. You will use onMenuItemClick() event handler to handle such event. </td> </tr> <tr > <td >onCreateContextMenu()</td> <td >onCreateContextMenuItemListener() This is called when the context menu is being built(as the result of a sustained "long click) </td> </tr> </tbody> </table> There are many more event listeners available as a part ofViewclass like OnHoverListener, OnDragListener etc which may be needed for your application. So I recommend to refer official documentation for Android application development in case you are going to develop a sophisticated apps. <h2 >Event Listeners Registration</h2> Event Registration is the process by which an Event Handler gets registered with an Event Listener so that the handler is called when the Event Listener fires the event. Though there are several tricky ways to register your event listener for any event, but I'm going to list down only top 3 ways, out of which you can use any of them based on the situation. <ul class="list" > <li > Using an Anonymous Inner Class </li> <li > Activity class implements the Listener interface. </li> <li > Using Layout file activity_main.xml to specify event handler directly. </li> </ul> Below section will provide you detailed examples on all the three scenarios − <h2 >Touch Mode</h2> Users can interact with their devices by using hardware keys or buttons or touching the screen.Touching the screen puts the device into touch mode. The user can then interact with it by touching the on-screen virtual buttons, images, etc.You can check if the device is in touch mode by calling the View class’s isInTouchMode() method. <img alt="Event" src="http://www.tutorialspoint.com/android/images/event.png" /> <h4 align="center" >TOUCH EVENT</h4> <h2 >Focus</h2> A view or widget is usually highlighted or displays a flashing cursor when it’s in focus. This indicates that it’s ready to accept input from the user. <ul class="list" > <li > isFocusable()– it returns true or false </li> <li > isFocusableInTouchMode()– checks to see if the view is focusable in touch mode. (A view may be focusable when using a hardware key but not when the device is in touch mode) </li> </ul> <pre class="prettyprint notranslate prettyprinted" > android:foucsUp="@=id/button_l"</pre> <h2 >onTouchEvent()</h2> <pre class="prettyprint prettyprinted" > public boolean onTouchEvent(motionEvent event){ switch(event.getAction()){ case TOUCH_DOWN: Toast.makeText(this,"you have clicked down Touch button",Toast.LENTH_LONG).show(); break(); case TOUCH_UP: Toast.makeText(this,"you have clicked up touch button",Toast.LENTH_LONG).show(); break; case TOUCH_MOVE: Toast.makeText(this,"you have clicked move touch button"Toast.LENTH_LONG).show(); break; } return super.onTouchEvent(event) ; }</pre> <h2 >Event Handling Examples</h2> <h3 >Event Listeners Registration Using an Anonymous Inner Class</h3> Here you will create an anonymous implementation of the listener and will be useful if each class is applied to a single control only and you have advantage to pass arguments to event handler. In this approach event handler methods can access private data of Activity. No reference is needed to call to Activity. But if you applied the handler to more than one control, you would have to cut and paste the code for the handler and if the code for the handler is long, it makes the code harder to maintain. Following are the simple steps to show how we will make use of separate Listener class to register and capture click event. Similar way you can implement your listener for any other required event type. <table class="table table-bordered" > <tbody > <tr > <th class="fivepct" >Step</th> <th >Description</th> </tr> <tr > <td >1</td> <td >You will use Android studio IDE to create an Android application and name it asmyapplicationunder a packagecom.example.myapplicationas explained in theHello World Examplechapter.</td> </tr> <tr > <td >2</td> <td >Modifysrc/MainActivity.javafile to add click event listeners and handlers for the two buttons defined.</td> </tr> <tr > <td >3</td> <td >Modify the detault content ofres/layout/activity_main.xmlfile to include Android UI controls.</td> </tr> <tr > <td >4</td> <td >No need to declare default string constants.Android studio takes care default constants.</td> </tr> <tr > <td >5</td> <td >Run the application to launch Android emulator and verify the result of the changes done in the aplication.</td> </tr> </tbody> </table> Following is the content of the modified main activity filesrc/com.example.myapplication/MainActivity.java. This file can include each of the fundamental lifecycle methods. <pre class="prettyprint notranslate prettyprinted" > package com.example.myapplication; public class MainActivity extends ActionBarActivity { private ProgressDialog progress; Button b1,b2; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); progress = new ProgressDialog(this); b1=(Button)findViewById(R.id.button); b2=(Button)findViewById(R.id.button2); b1.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { TextView txtView = (TextView) findViewById(R.id.textView); txtView.setTextSize(25); } }); b2.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { TextView txtView = (TextView) findViewById(R.id.textView); txtView.setTextSize(55); } }); } @Override public boolean onCreateOptionsMenu(Menu menu) { // Inflate the menu; this adds items to the action bar if it is present. getMenuInflater().inflate(R.menu.menu_main, menu); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { // Handle action bar item clicks here. The action bar will // automatically handle clicks on the Home/Up button, so long // as you specify a parent activity in AndroidManifest.xml. int id = item.getItemId(); //noinspection SimplifiableIfStatement if (id == R.id.action_settings) { return true; } return super.onOptionsItemSelected(item); } }</pre> Following will be the content ofres/layout/activity_main.xmlfile − <pre class="prettyprint notranslate prettyprinted" > <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:paddingBottom="@dimen/activity_vertical_margin" android:paddingLeft="@dimen/activity_horizontal_margin" android:paddingRight="@dimen/activity_horizontal_margin" android:paddingTop="@dimen/activity_vertical_margin" tools:context=".MainActivity"> <TextView android:id="@+id/textView1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Event Handling " android:layout_alignParentTop="true" android:layout_centerHorizontal="true" android:textSize="30dp"/> <TextView android:id="@+id/textView2" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Tutorials point " android:textColor="#ff87ff09" android:textSize="30dp" android:layout_above="@+id/imageButton" android:layout_centerHorizontal="true" android:layout_marginBottom="40dp" /> <ImageButton android:layout_width="wrap_content" android:layout_height="wrap_content" android:id="@+id/imageButton" android:src="@drawable/abc" android:layout_centerVertical="true" android:layout_centerHorizontal="true" /> <Button android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Small font" android:id="@+id/button" android:layout_below="@+id/imageButton" android:layout_centerHorizontal="true" /> <Button android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Large Font" android:id="@+id/button2" android:layout_below="@+id/button" android:layout_alignRight="@+id/button" android:layout_alignEnd="@+id/button" /> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Hello World!" android:id="@+id/textView" android:layout_below="@+id/button2" android:layout_centerHorizontal="true" android:textSize="25dp" /> </RelativeLayout></pre> Following will be the content ofres/values/strings.xmlto define two new constants − <pre class="prettyprint notranslate prettyprinted" > <?xml version="1.0" encoding="utf-8"?> <resources> <string name="app_name">myapplication</string> <string name="action_settings">Settings</string> </resources></pre> Following is the default content ofAndroidManifest.xml− <pre class="prettyprint notranslate prettyprinted" > <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapplication" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="22" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="com.example.myapplication.MainActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest></pre> Let's try to run yourmyapplicationapplication. I assume you had created yourAVDwhile doing environment setup. To run the app from Android Studio, open one of your project's activity files and click Run<img alt="Eclipse Run Icon" class="inline" src="http://www.tutorialspoint.com/android/images/eclipse_run.png" />icon from the toolbar. Android Studio installs the app on your AVD and starts it and if everything is fine with your setup and application, it will display following Emulator window − <img alt="Android Event Handling" src="http://www.tutorialspoint.com/android/images/event1.png" /> Now you try to click on two buttons, one by one and you will see that font of theHello Worldtext will change, which happens because registered click event handler method is being called against each click event. <h2 >Exercise</h2> I will recommend to try writing different event handlers for different event types and understand exact difference in different event types and their handling. Events related to menu, spinner, pickers widgets are little different but they are also based on the same concepts as explained above.