CoreTextEditContext Clase

Definición

Espacio de nombres:

Windows.UI.Text.Core

Objeto principal utilizado por los controles de entrada de texto para comunicarse con el 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

Herencia

Object Platform::Object IInspectable CoreTextEditContext

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Para obtener un objeto de este tipo, llame a CoreTextServicesManager.CreateEditContext.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1511	10586	NotifyFocusLeaveCompleted

Propiedades

InputPaneDisplayPolicy	Obtiene o establece un valor que indica si el panel de entrada se debe mostrar automáticamente cuando el foco entra en el control de entrada de texto. El valor predeterminado es Automático, lo que indica que el panel de entrada se mostrará automáticamente. Un valor de Manual indica que la aplicación será responsable de mostrar y ocultar el panel de entrada mediante InputPane.TryShow y TryHide.
InputScope	Obtiene o establece un valor que indica el ámbito de entrada del control de entrada de texto.
IsReadOnly	Obtiene o establece un valor que indica si el control de edición es editable.
Name	Obtiene o establece un nombre descriptivo para el control de entrada de texto. Normalmente, un marco de trabajo de aplicación usa propiedades como "name" o "id" para identificar un control, por lo que se recomienda establecer esta propiedad en consecuencia en el servidor de entrada de texto para que los procesadores de entrada puedan conservar mejor el contexto de entrada y proporcionar mejores sugerencias.

Métodos

NotifyFocusEnter()	Notifica al servidor de entrada de texto que el foco ha escrito el control de entrada de texto.
NotifyFocusLeave()	Notifica al servidor de entrada de texto que el foco ha dejado el control de entrada de texto.
NotifyLayoutChanged()	Notifica al servidor de entrada de texto que ha cambiado el diseño del texto dentro del control de entrada de texto.
NotifySelectionChanged(CoreTextRange)	Notifica al servidor de entrada de texto cualquier cambio que el control de entrada de texto necesite realizar en el intervalo de selección. Esto es importante para mantener sincronizado el estado interno del control y el estado interno del servidor.
NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)	Notifica al servidor de entrada de texto cualquier cambio que el control de entrada de texto necesite realizar en el texto. Esto es importante para mantener sincronizado el estado interno del control y el estado interno del servidor. Dado que un cambio en el texto también es probable que afecte al intervalo de selección, el método toma el intervalo de selección como parámetro.

Eventos

CompositionCompleted	Se produce cuando se ha completado la composición.
CompositionStarted	Se produce cuando se ha iniciado la composición.
FocusRemoved	Se produce cuando el foco se quitó forzosamente de un control de entrada de texto. La aplicación debe controlar este evento para quitar el foco del control de entrada de texto en consecuencia.
FormatUpdating	Se produce cuando el servidor de entrada de texto debe aplicar un formato diferente a un intervalo de texto determinado. Esto suele ocurrir durante la composición.
LayoutRequested	Se produce cuando el servidor de entrada de texto necesita obtener el rectángulo delimitador de un intervalo de texto y del propio control de entrada de texto. La aplicación debe controlar este evento y devolver la información de geometría solicitada.
NotifyFocusLeaveCompleted	Se produce después de que el foco haya dejado el control de entrada de texto.
SelectionRequested	Se produce cuando el servidor de entrada de texto necesita obtener el intervalo de texto que representa el texto seleccionado actualmente en el control de entrada de texto. La aplicación debe controlar este evento y devolver el intervalo solicitado.
SelectionUpdating	Se produce cuando el servidor de entrada de texto necesita modificar el intervalo de texto seleccionado actualmente en el control de entrada de texto. Este evento podría ser el resultado de que un procesador de entrada necesite seleccionar texto o mover el símbolo de intercalación. El control de entrada de texto debe establecer su intervalo de selección en consecuencia.
TextRequested	Se produce cuando el servidor de entrada de texto necesita obtener un intervalo de texto del control de entrada de texto. La aplicación debe controlar este evento y devolver el intervalo solicitado.
TextUpdating	Se produce cuando el servidor de entrada de texto necesita modificar el texto dentro del control de entrada de texto. Este evento podría ser el resultado de un evento de clave, como insertar un solo carácter, o el resultado del procesamiento realizado por un procesador de entrada, como la corrección automática y la predicción. Al controlar el evento, el control de entrada de texto debe reemplazar un intervalo por el nuevo texto proporcionado por el servidor y también mover el símbolo de intercalación al final del nuevo texto.

Consulte también

• Ejemplo de control de edición personalizado