Android 简明教程

Android - Spelling Checker

Android 平台提供了一个拼写检查框架，该框架允许你在应用程序中实现拼写检查并对其进行访问。

为了使用拼写检查器，你需要实现 SpellCheckerSessionListener 接口并重写它的方法。其语法如下所示：

public class HelloSpellCheckerActivity extends Activity implements SpellCheckerSessionListener {
   @Override
   public void onGetSuggestions(final SuggestionsInfo[] arg0) {
      // TODO Auto-generated method stub
   }

   @Override
   public void onGetSentenceSuggestions(SentenceSuggestionsInfo[] arg0) {
      // TODO Auto-generated method stub
   }
}

你接下来需要做的是创建一个 SpellCheckerSession 类的对象。可以通过调用 TextServicesManager 类的 newSpellCheckerSession 方法来实例化此对象。该类处理应用程序和文本服务之间的交互。你需要请求系统服务来实例化它。其语法如下所示：

private SpellCheckerSession mScs;
final TextServicesManager tsm = (TextServicesManager) getSystemService(
Context.TEXT_SERVICES_MANAGER_SERVICE);
mScs = tsm.newSpellCheckerSession(null, null, this, true);

你要做的最后一件事是调用 getSuggestions 方法来为任何你想要的文本获取建议。建议将传递到 onGetSuggestions 方法，你可以从中执行任何你想要的操作。

mScs.getSuggestions(new TextInfo(editText1.getText().toString()), 3);

此方法采用两个参数。第一个参数是文本信息对象形式的字符串，第二个参数是用于区分建议的 cookie 编号。

除了上述方法， SpellCheckerSession 类还提供了其他用于更好处理建议的方法。这些方法如下所示 −

Sr.No

Method & description

1

cancel() 取消挂起的和正在运行的拼写检查任务

2

close() 完成此会话并允许 TextServicesManagerService 断开已绑定拼写检查器连接

3

getSentenceSuggestions(TextInfo[] textInfos, int suggestionsLimit) 从指定句子获取建议

4

getSpellChecker() 获取该拼写检查器会话拥有的拼写检查器服务信息。

5

isSessionDisconnected() 如果此会话的文本服务的连接断开且处于非活动状态，则为 True。

Example

以下是一个演示如何使用拼写检查器的示例。它创建了一个基本的拼写检查应用程序，您可以使用该应用程序编写文本和获取建议。

要使用此示例，你可以在实际设备或模拟器上运行此示例。

Steps

Description

1

你将使用 Android Studio 在包 com.example.sairamkrishna.myapplication 下创建 Android 应用程序。

2

修改 src/MainActivity.java 文件以添加必要的代码。

3

修改 res/layout/main 以添加各个 XML 组件

4

运行应用程序并选择正在运行的 Android 设备，并将应用程序安装在其上并验证结果

以下是修改的主活动文件 src/MainActivity.java 的内容。

package com.example.sairamkrishna.myapplication;

import android.app.Activity;
import android.content.Context;
import android.os.Bundle;
import android.view.View;
import android.view.textservice.TextInfo;
import android.view.textservice.TextServicesManager;

import android.widget.Button;
import android.widget.EditText;

import android.view.textservice.SentenceSuggestionsInfo;
import android.view.textservice.SpellCheckerSession;
import android.view.textservice.SpellCheckerSession.SpellCheckerSessionListener;
import android.view.textservice.SuggestionsInfo;

import android.widget.TextView;
import android.widget.Toast;

public class MainActivity extends Activity implements SpellCheckerSessionListener  {
   Button b1;
   TextView tv1;
   EditText ed1;
   private SpellCheckerSession mScs;

   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      b1=(Button)findViewById(R.id.button);
      tv1=(TextView)findViewById(R.id.textView3);

      ed1=(EditText)findViewById(R.id.editText);
      b1.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            Toast.makeText(getApplicationContext(),
               ed1.getText().toString(),Toast.LENGTH_SHORT).show();
            mScs.getSuggestions(new TextInfo(ed1.getText().toString()), 3);
         }
      });
   }

   public void onResume() {
      super.onResume();
      final TextServicesManager tsm = (TextServicesManager)
         getSystemService(Context.TEXT_SERVICES_MANAGER_SERVICE);
      mScs = tsm.newSpellCheckerSession(null, null, this, true);
   }

   public void onPause() {
      super.onPause();
      if (mScs != null) {
         mScs.close();
      }
   }

   public void onGetSuggestions(final SuggestionsInfo[] arg0) {
      final StringBuilder sb = new StringBuilder();

      for (int i = 0; i < arg0.length; ++i) {
         // Returned suggestions are contained in SuggestionsInfo
         final int len = arg0[i].getSuggestionsCount();
         sb.append('\n');

         for (int j = 0; j < len; ++j) {
            sb.append("," + arg0[i].getSuggestionAt(j));
         }

         sb.append(" (" + len + ")");
      }

      runOnUiThread(new Runnable() {
         public void run() {
            tv1.append(sb.toString());
         }
      });
   }

   @Override
   public void onGetSentenceSuggestions(SentenceSuggestionsInfo[] arg0) {
      // TODO Auto-generated method stub
   }
}

以下是修改的 XML res/layout/main.xml 的内容。

<?xml version="1.0" encoding="utf-8"?>
<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:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity">

   <TextView android:text="Spell checker " android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textview"
      android:textSize="35dp"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true" />

   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials point"
      android:id="@+id/textView"
      android:layout_below="@+id/textview"
      android:layout_centerHorizontal="true"
      android:textColor="#ff7aff24"
      android:textSize="35dp" />

   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Suggestions"
      android:id="@+id/button"
      android:layout_alignParentBottom="true"
      android:layout_centerHorizontal="true" />

   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText"
      android:hint="Enter Text"
      android:layout_above="@+id/button"
      android:layout_marginBottom="56dp"
      android:focusable="true"
      android:textColorHighlight="#ff7eff15"
      android:textColorHint="#ffff25e6"
      android:layout_alignRight="@+id/textview"
      android:layout_alignEnd="@+id/textview"
      android:layout_alignLeft="@+id/textview"
      android:layout_alignStart="@+id/textview" />

   <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:src="@drawable/abc"
      android:layout_below="@+id/textView"
      android:layout_centerHorizontal="true" />

   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Suggestions"
      android:id="@+id/textView3"
      android:textSize="25sp"
      android:layout_below="@+id/imageView" />

</RelativeLayout>

以下是 res/values/string.xml 的内容。

<resources>
   <string name="app_name">My Application</string>
</resources>

下面是 AndroidManifest.xml 文件的内容。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.sairamkrishna.myapplication" >

   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >

      <activity
         android:name=".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>

我们尝试运行刚刚修改的应用程序。我假设您在做环境设置的时候已经生成了您的 AVD 。要从 Android Studio 运行应用程序，请打开您项目的某个活动文件并单击工具栏上的运行图标。Android Studio 会将应用程序安装在您的 AVD 上并启动它，如果您的设置和应用程序一切正常，它将显示以下模拟器窗口 −

spell

现在，您需要做的是在字段中输入任何文本。例如，我已经输入了一些文本。按建议按钮。您的 AVD 中将显示以下通知，以及建议 −

spell1

现在更改文本并再次按按钮，就像我所做的那样。这便是屏幕上出现的内容。

spell2