Android的AutoCompleteTextView在API17高版本添加的setText函数在低版本系统居然能正常调用？官方文档是不是不靠谱了？...

爱被打了一巴掌 2021-11-09 23:22 90阅读 0赞

官方文档：[https://developer.android.com/reference/android/widget/AutoCompleteTextView.html\#setText(java.lang.CharSequence, boolean)][https_developer.android.com_reference_android_widget_AutoCompleteTextView.html_setText_java.lang.CharSequence_ boolean]

#### public void setText ([CharSequence][] text, boolean filter) ####

Added in  [API level 17][]

Like `setText(CharSequence)`, except that it can disable filtering.

##### Parameters #####

<table style="width:428px;"> 
 <tbody> 
  <tr> 
   <th>filter</th> 
   <td>If&nbsp;<code>false</code>, no filtering will be performed as a result of this call.</td> 
  </tr> 
 </tbody> 
</table>

//官方文档标注为**API.17**才添加：public void setText(CharSequence text, boolean filter)  
//Android Lint 是会检测到错误的！  
//但是经过实际的机器测试**中兴U880的2.2系统API8**居然运行一切正常！很奇葩！  
//为了以防万一，还是做一下异常处理

try  
\{  
this.mCuurentView.setText(“something”, false);  
\}  
catch (final Exception ex)  
\{  
LogEx.e("setText(CharSequence text, boolean filter)果然报错了！", ex);

android - why high API level added method AutoCompleteTextView.setText(CharSequence, boolean) run on low API level device work well - Stack Overflow  
[http://stackoverflow.com/questions/29894904/why-high-api-level-added-method-autocompletetextview-settextcharsequence-boole/29958789\#29958789][http_stackoverflow.com_questions_29894904_why-high-api-level-added-method-autocompletetextview-settextcharsequence-boole_29958789_29958789]

<table> 
 <tbody> 
  <tr> 
   <td> 
    <div> 
     <span>Another possibility is that the method had been in Android for some time, but was marked with&nbsp;<code>@hide</code>&nbsp;and therefore was excluded from the Android SDK. Not every device before API Level 17 will necessarily have that method, as device manufacturers can change anything that is not part of the Android SDK.&nbsp;–&nbsp;&nbsp;<a title="463125 reputation" href="http://stackoverflow.com/users/115145/commonsware" rel="nofollow">CommonsWare</a><span><span title="2015-04-27 12:02:58Z">2 days ago</span></span></span> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

Thanks [CommonsWare][]!

Android 2.2.3 Source Code Cross Reference: [AutoCompleteTextView.java\#setText][AutoCompleteTextView.java_setText]

/**
    967     * Like {@link #setText(CharSequence)}, except that it can disable filtering.
    968     *
    969     * @param filter If <code>false</code>, no filtering will be performed
    970     *        as a result of this call.
    971     *
    972     * @hide Pending API council approval.
    973     */
    974    public void setText(CharSequence text, boolean filter) {
    975        if (filter) {
    976            setText(text);
    977        } else {
    978            mBlockCompletion = true;
    979            setText(text);
    980            mBlockCompletion = false;
    981        }
    982    }

转载于:https://www.cnblogs.com/AsionTang/p/4461079.html

[https_developer.android.com_reference_android_widget_AutoCompleteTextView.html_setText_java.lang.CharSequence_ boolean]: https://developer.android.com/reference/android/widget/AutoCompleteTextView.html#setText%28java.lang.CharSequence,%20boolean%29
[CharSequence]: https://developer.android.com/reference/java/lang/CharSequence.html
[API level 17]: https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels
[http_stackoverflow.com_questions_29894904_why-high-api-level-added-method-autocompletetextview-settextcharsequence-boole_29958789_29958789]: http://stackoverflow.com/questions/29894904/why-high-api-level-added-method-autocompletetextview-settextcharsequence-boole/29958789#29958789
[CommonsWare]: http://stackoverflow.com/users/115145/commonsware
[AutoCompleteTextView.java_setText]: http://androidxref.com/2.2.3/xref/frameworks/base/core/java/android/widget/AutoCompleteTextView.java#974