IInputConnectionExtensions.SetComposingText Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Descrição |
|---|---|
| SetComposingText(IInputConnection, String, Int32) |
Substitua o texto atualmente redigindo pelo texto especificado e defina a nova posição do cursor. |
| SetComposingText(IInputConnection, String, Int32, TextAttribute) |
A variante de setComposingText(CharSequence,int). |
SetComposingText(IInputConnection, String, Int32)
Substitua o texto atualmente redigindo pelo texto especificado e defina a nova posição do cursor.
public static bool SetComposingText(this Android.Views.InputMethods.IInputConnection self, string? text, int newCursorPosition);
static member SetComposingText : Android.Views.InputMethods.IInputConnection * string * int -> bool
Parâmetros
- self
- IInputConnection
A conexão de entrada na qual chamar o método.
- text
- String
O texto de composição. O estilo padrão para compor texto é usado.
- newCursorPosition
- Int32
A nova posição do cursor em torno do texto. Se > 0, isso é relativo ao final do texto – 1; se <= 0, isso é relativo ao início do texto. Portanto, um valor de 1 sempre avançará você para a posição após a inserção do texto completo. Observe que isso significa que você não pode posicionar o cursor dentro do texto, pois o editor pode fazer modificações no texto que você está fornecendo para que não seja possível especificar corretamente os locais lá.
Retornos
true no êxito, false se a conexão de entrada não for mais válida.
Comentários
Substitua o texto atualmente redigindo pelo texto especificado e defina a nova posição do cursor. Qualquer conjunto de texto de composição anteriormente será removido automaticamente.
Se houver algum intervalo de composição atualmente ativo, todos os caracteres que ele compreende serão removidos. O texto passado é adicionado em seu lugar e um intervalo de composição é adicionado a este texto. Se não houver nenhuma extensão de composição ativa, o texto passado será adicionado na posição do cursor (removendo caracteres selecionados primeiro, se houver), e um intervalo de composição será adicionado ao novo texto. Por fim, o cursor é movido para o local especificado por newCursorPosition.
Isso geralmente é chamado por IMEs para adicionar ou remover ou alterar caracteres no intervalo de composição. Chamar esse método fará com que o editor chame InputMethodService.onUpdateSelection(int, int, int, int, int) no IME atual após o fim da entrada do lote.
Autores do editor: tenha em mente que o texto pode ser muito semelhante ou completamente diferente do que estava no período de composição no momento da chamada ou pode não haver um intervalo de composição. Observe que, embora não seja um uso típico, a cadeia de caracteres pode estar vazia. Trate isso normalmente, substituindo o texto atualmente redigindo por uma cadeia de caracteres vazia. Além disso, tenha cuidado com a posição do cursor. Os IMEs dependem que isso funcione exatamente conforme descrito acima. Como isso altera o conteúdo do editor, você precisa fazer as alterações conhecidas no método de entrada chamando InputMethodManager.updateSelection(android.view.View,int,int,int,int), mas tenha cuidado para aguardar até que a edição do lote seja concluída se uma estiver em andamento. Observe que esse método pode definir a posição do cursor na borda do texto de composição ou totalmente fora dele, mas o IME também pode passar a mover a posição do cursor para dentro do texto de composição em uma chamada subsequente para que você não faça nenhuma suposição: o texto compondo e a seleção são totalmente independentes.
Referência do Android para android.view.inputmethod.InputConnection.setComposingText.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Aplica-se a
SetComposingText(IInputConnection, String, Int32, TextAttribute)
A variante de setComposingText(CharSequence,int).
public static bool SetComposingText(this Android.Views.InputMethods.IInputConnection self, string text, int newCursorPosition, Android.Views.InputMethods.TextAttribute? textAttribute);
static member SetComposingText : Android.Views.InputMethods.IInputConnection * string * int * Android.Views.InputMethods.TextAttribute -> bool
Parâmetros
- self
- IInputConnection
A conexão de entrada na qual chamar o método.
- text
- String
O texto de composição. O estilo padrão para compor texto é usado. Esse valor não pode ser nulo.
- newCursorPosition
- Int32
A nova posição do cursor em torno do texto. Se > 0, isso é relativo ao final do texto – 1; se <= 0, isso é relativo ao início do texto. Portanto, um valor de 1 sempre avançará você para a posição após a inserção do texto completo. Observe que isso significa que você não pode posicionar o cursor dentro do texto, pois o editor pode fazer modificações no texto que você está fornecendo para que não seja possível especificar corretamente os locais lá.
- textAttribute
- TextAttribute
As informações extras sobre o texto. Esse valor pode ser nulo.
Retornos
true no êxito, false se a conexão de entrada não for mais válida.
Comentários
A variante de setComposingText(CharSequence,int). Esse método é usado para permitir que o IME forneça informações extras ao configurar o texto de composição.
Referência do Android para android.view.inputmethod.InputConnection.setComposingText.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.