InputMethod.AccessibilityInputConnection.GetSurroundingText Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den umgebenden Text um den aktuellen Cursor, mit <var>beforeLength</var> characters of text before the cursor (start of the selection), <var>afterLength</var> characters of text after the cursor (end of the selection) and all of the selected text.
[Android.Runtime.Register("getSurroundingText", "(III)Landroid/view/inputmethod/SurroundingText;", "", ApiSince=33)]
public Android.Views.InputMethods.SurroundingText? GetSurroundingText (int beforeLength, int afterLength, int flags);[<Android.Runtime.Register("getSurroundingText", "(III)Landroid/view/inputmethod/SurroundingText;", "", ApiSince=33)>]
member this.GetSurroundingText : int * int * int -> Android.Views.InputMethods.SurroundingTextParameter
- beforeLength
- Int32
Die erwartete Länge des Texts vor dem Cursor.
- afterLength
- Int32
Die erwartete Textlänge nach dem Cursor.
- flags
- Int32
Liefert zusätzliche Optionen, die steuern, wie der Text zurückgegeben wird. Kann entweder 0 oder InputConnection#GET_TEXT_WITH_STYLES.
Gibt zurück
ein android.view.inputmethod.SurroundingText Objekt, das den umgebenden Text und den Zustand der Auswahl beschreibt, oder null, wenn die Eingabeverbindung nicht mehr gültig ist, oder der Editor kann die Anforderung aus irgendeinem Grund nicht erfüllen, oder die Anwendung implementiert diese Methode nicht. Die Länge des zurückgegebenen Texts kann kleiner als die Summe von <Var>beforeLength</var> und <var>afterLength</var> sein.
- Attribute
Hinweise
Ruft den umgebenden Text um den aktuellen Cursor, mit <var>beforeLength</var> characters of text before the cursor (start of the selection), <var>afterLength</var> characters of text after the cursor (end of the selection) and all of the selected text. Der Bereich gilt für Java-Zeichen und nicht für Glyphen, die mehrere Zeichen sein können.
Diese Methode kann fehlschlagen, wenn die Eingabeverbindung ungültig wurde (z. B. der Prozessabsturz), oder der Client dauert zu lange, um mit dem Text zu antworten (es wird ein paar Sekunden zurückgegeben), oder das Protokoll wird nicht unterstützt. In einem dieser Fälle wird NULL zurückgegeben.
Diese Methode wirkt sich weder auf den Text im Editor aus, noch wirkt sie sich auf die Auswahl- oder Erstellungsspanne aus.
Wenn InputConnection#GET_TEXT_WITH_STYLES als Kennzeichnungen angegeben wird, sollte der Editor eine android.text.Spanned mit allen für den Text festgelegten Spannen zurückgeben.
<starke>Autoren des Barrierefreiheitsdiensts:</starke> Bedenken Sie, dass dies einen IPC-Roundtrip auslöst, der einige Zeit in Anspruch nimmt. Gehen Sie davon aus, dass diese Methode viel Zeit beansprucht.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.