CoreTextEditContext Classe

Definição

Namespace:

Windows.UI.Text.Core

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

ContractVersionAttribute MarshalingBehaviorAttribute

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.

Confira também

• Exemplo de controle de edição personalizado