Compartilhar via


CoreTextEditContext Classe

Definição

O objeto primário usado pelos controles de entrada de texto para se comunicar com o servidor de entrada de texto.

public ref class CoreTextEditContext sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreTextEditContext final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreTextEditContext
Public NotInheritable Class CoreTextEditContext
Herança
Object Platform::Object IInspectable CoreTextEditContext
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Para obter um objeto desse tipo, chame CoreTextServicesManager.CreateEditContext.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1511 10586 NotifyFocusLeaveCompleted

Propriedades

InputPaneDisplayPolicy

Obtém ou define um valor que indica se o painel de entrada deve ser mostrado automaticamente quando o foco entra no controle de entrada de texto. O valor padrão é Automático, indicando que o painel de entrada será mostrado automaticamente. Um valor de Manual indica que seu aplicativo será responsável por mostrar e ocultar o painel de entrada usando InputPane.TryShow e TryHide.

InputScope

Obtém ou define um valor que indica o escopo de entrada do controle de entrada de texto.

IsReadOnly

Obtém ou define um valor que indica se o controle de edição é editável.

Name

Obtém ou define um nome descritivo para o controle de entrada de texto. Uma estrutura de aplicativo geralmente usa propriedades como "name" ou "id" para identificar um controle, portanto, é recomendável que você defina essa propriedade adequadamente no servidor de entrada de texto para que os processadores de entrada possam preservar melhor o contexto de entrada e fornecer melhores sugestões.

Métodos

NotifyFocusEnter()

Notifica o servidor de entrada de texto que o foco inseriu o controle de entrada de texto.

NotifyFocusLeave()

Notifica o servidor de entrada de texto que o foco deixou o controle de entrada de texto.

NotifyLayoutChanged()

Notifica o servidor de entrada de texto de que o layout do texto dentro do controle de entrada de texto foi alterado.

NotifySelectionChanged(CoreTextRange)

Notifica o servidor de entrada de texto sobre qualquer alteração que o controle de entrada de texto precisa fazer no intervalo de seleção. Isso é importante para manter o estado interno do controle e o estado interno do servidor sincronizados.

NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)

Notifica o servidor de entrada de texto sobre qualquer alteração que o controle de entrada de texto precisa fazer no texto. Isso é importante para manter o estado interno do controle e o estado interno do servidor sincronizados. Como uma alteração no texto também pode afetar o intervalo de seleção, o método usa o intervalo de seleção como um parâmetro.

Eventos

CompositionCompleted

Ocorre quando a composição é concluída.

CompositionStarted

Ocorre quando a composição é iniciada.

FocusRemoved

Ocorre quando o foco foi removido à força de um controle de entrada de texto. O aplicativo deve manipular esse evento para remover o foco do controle de entrada de texto adequadamente.

FormatUpdating

Ocorre quando o servidor de entrada de texto precisa aplicar um formato diferente a um determinado intervalo de texto. Isso geralmente acontece durante a composição.

LayoutRequested

Ocorre quando o servidor de entrada de texto precisa obter a caixa delimitadora de um intervalo de texto e do próprio controle de entrada de texto. O aplicativo deve manipular esse evento e retornar as informações de geometria solicitadas.

NotifyFocusLeaveCompleted

Ocorre depois que o foco deixou o controle de entrada de texto.

SelectionRequested

Ocorre quando o servidor de entrada de texto precisa obter o intervalo de texto que representa o texto selecionado no momento no controle de entrada de texto. O aplicativo deve manipular esse evento e retornar o intervalo solicitado.

SelectionUpdating

Ocorre quando o servidor de entrada de texto precisa modificar o intervalo de texto selecionado atualmente no controle de entrada de texto. Esse evento pode ser o resultado de um processador de entrada que precisa selecionar algum texto ou mover o cursor. O controle de entrada de texto deve definir seu intervalo de seleção adequadamente.

TextRequested

Ocorre quando o servidor de entrada de texto precisa obter um intervalo de texto do controle de entrada de texto. O aplicativo deve manipular esse evento e retornar o intervalo solicitado.

TextUpdating

Ocorre quando o servidor de entrada de texto precisa modificar o texto dentro do controle de entrada de texto. Esse evento pode ser o resultado de um evento chave, como a inserção de um único caractere, ou o resultado do processamento feito por um processador de entrada, como correção automática e previsão.

Ao manipular o evento, o controle de entrada de texto deve substituir um intervalo pelo novo texto fornecido pelo servidor e também mover o cursor para o final do novo texto.

Aplica-se a

Confira também