Partager via


IInputConnection.GetTextBeforeCursorFormatted(Int32, GetTextFlags) Méthode

Définition

Obtenez les <>caractères var n</var> du texte avant la position actuelle du curseur.

[Android.Runtime.Register("getTextBeforeCursor", "(II)Ljava/lang/CharSequence;", "GetGetTextBeforeCursor_IIHandler:Android.Views.InputMethods.IInputConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Lang.ICharSequence? GetTextBeforeCursorFormatted (int n, Android.Views.InputMethods.GetTextFlags flags);
[<Android.Runtime.Register("getTextBeforeCursor", "(II)Ljava/lang/CharSequence;", "GetGetTextBeforeCursor_IIHandler:Android.Views.InputMethods.IInputConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member GetTextBeforeCursorFormatted : int * Android.Views.InputMethods.GetTextFlags -> Java.Lang.ICharSequence

Paramètres

n
Int32

Longueur attendue du texte. Cela doit être non négatif.

flags
GetTextFlags

Fournit des options supplémentaires qui contrôlent la façon dont le texte est retourné. Peut être soit 0 ou #GET_TEXT_WITH_STYLES.

Retours

le texte avant la position du curseur ; la longueur du texte retourné peut être inférieure à <var>n</var>.

Attributs

Remarques

Obtenez les <>caractères var n</var> du texte avant la position actuelle du curseur.

Cette méthode peut échouer si la connexion d’entrée est devenue non valide (par exemple, son blocage de processus) ou si l’éditeur prend trop de temps pour répondre avec le texte (il est donné quelques secondes pour retourner). Dans les deux cas, la valeur Null est retournée. Cette méthode n’affecte pas le texte de l’éditeur d’une manière quelconque, ni n’affecte-t-elle les étendues de sélection ou de composition.

S’il #GET_TEXT_WITH_STYLES est fourni en tant qu’indicateurs, l’éditeur doit retourner une android.text.SpannableString plage avec toutes les étendues définies sur le texte.

<auteurs forts>de l’IME :</strong> s’il vous plaît envisager cela déclenchera un aller-retour IPC qui prendra un certain temps. Supposons que cette méthode consomme beaucoup de temps. En outre, n’oubliez pas que l’Éditeur peut choisir de retourner moins de caractères que demandés même s’ils sont disponibles pour des raisons de performances. Si vous utilisez ceci pour obtenir le texte initial autour du curseur, vous pouvez envisager d’utiliser EditorInfo#getInitialTextBeforeCursor(int, int), EditorInfo#getInitialSelectedText(int)et EditorInfo#getInitialTextAfterCursor(int, int) d’éviter les coûts IPC.

<>auteurs forts de l’éditeur :</strong> veuillez faire attention aux conditions de concurrence lors de l’implémentation de cet appel. Un IME peut apporter une modification au texte et utiliser cette méthode immédiatement ; vous devez vous assurer que la valeur retournée est cohérente avec le résultat des dernières modifications. En outre, vous pouvez retourner moins de n caractères si les performances le dictent, mais gardez à l’esprit que les imEs s’appuient sur cela pour de nombreuses fonctions : vous ne devez pas, par exemple, limiter la valeur retournée à la ligne actuelle, et spécifiquement ne pas retourner 0 caractères, sauf si le curseur est vraiment au début du texte.

Documentation Java pour android.view.inputmethod.InputConnection.getTextBeforeCursor(int, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à