Patrón de control TextEdit
Presenta instrucciones y convenciones para implementar ITextEditProvider, incluida información sobre propiedades y métodos. El patrón de control TextEdit se usa para el acceso mediante programación a un control que modifica el texto, por ejemplo, un control que realiza la corrección automática o habilita la composición de entrada.
Nota
Las notas de implementación de este tema hacen referencia a las API que proceden de Text Services Framework (TSF). Para obtener más información sobre TSF y la referencia de api, consulte Text Services Framework.
Miembros necesarios para ITextEditProvider
Estas propiedades y métodos son necesarios para implementar la interfaz ITextEditProvider .
| Miembros requeridos | Tipo de miembro | Notas |
|---|---|---|
| GetActiveComposition | Método | Devuelve el intervalo de la conversión actual (ninguno si no hay ninguna conversión). Devuelve la composición activa (en TSF, este es el intervalo marcado por GUID_PROP_COMPOSING). Por ejemplo, con el Editor de métodos de entrada japonés (IME) de Microsoft, este sería el texto subrayado completo. |
| GetConversionTarget | Método | Devuelve el intervalo de destino de conversión actual (ninguno si no hay ninguna conversión). En TSF, este es el intervalo de caracteres marcados como TF_ATTR_TARGET_NOTCONVERTED o TF_ATTR_TARGET_CONVERTED de la estructura de TF_DISPLAYATTRIBUTE . |
Los eventos TextEditTextChanged y ConversionTargetChanged son necesarios para que Los elementos de Microsoft Automatización de la interfaz de usuario admitan el patrón TextEdit.
TextEditTextChanged
- Use la función UiaRaiseTextEditTextChangedEvent para generar el evento TextEditTextChanged .
- En la tabla siguiente se enumeran los casos en los que se debe generar el evento y los parámetros UiaRaiseTextEditTextChangedEvent que se van a usar.
| TextEditChangeType | Carga del evento | Notas |
|---|---|---|
| Autocorrección | Nueva cadena corregida | Se genera cuando el control realiza una corrección automática. O cada vez que se realiza un reemplazo a través de TSF y el intervalo tiene un valor de GUID_PROP_TKB_ALTERNATES de TKB_ALTERNATES_AUTOCORRECTION_APPLIED. |
| Composición | Cadena actualizada | La carga solo debe incluir los caracteres que han cambiado (no envíe toda la cadena de composición). Se genera cada vez que se realiza un reemplazo de composición. En TSF, un reemplazo de composición se define como un reemplazo que tiene la marca GUID_PROP_COMPOSING establecida. Editar controles que implementan TSF puede supervisar estos cambios a través de la notificación OnEndEdit . |
| CompositionFinalized | La cadena de composición finalizada (vea Notas) | En TSF, la cadena de conversión que se está finalizando se define mediante la marca GUID_PROP_COMPOSING que se quita de una composición. Los controles de edición que implementan TSF deben determinar la cadena finalizada de EndComposition y generar el evento cuando se llama a OnEndEdit . La cadena de composición finalizada puede estar vacía si se canceló o eliminó la composición. |
ConversionTargetChanged
- ConversionTargetChanged se produce cuando el destino de conversión cambia de un destino a otro.
- Use la función UiaRaiseAutomationEvent para generar el evento ConversionTargetChanged (pase el identificador de evento UIA_TextEdit_ConversionTargetChangedEventId ).
- ConversionTargetChanged no debe generarse cuando cambia el contenido del destino. Si el cambio de destino se produce simultáneamente con un cambio de composición, el evento de cambio de destino debe generarse después de que ya se hayan generado eventos de composición.
- En TSF, el destino de conversión se define mediante el valor TF_ATTR_TARGET_CONVERTED que se establece desde la estructura de TF_DISPLAYATTRIBUTE . Los cambios se pueden supervisar mediante OnEndEdit.