IVsFinalTextChangeCommitEvents (Interfaz)

Notifica a clientes de gestos último de confirmación para desencadenar el evento y proporciona el intervalo de texto cambiado.

Espacio de nombres:  Microsoft.VisualStudio.TextManager.Interop
Ensamblado:  Microsoft.VisualStudio.TextManager.Interop (en Microsoft.VisualStudio.TextManager.Interop.dll)

Sintaxis

'Declaración
<InterfaceTypeAttribute()> _
<GuidAttribute("CE62717C-797D-445F-BC89-1D02C54CCF96")> _
Public Interface IVsFinalTextChangeCommitEvents

[InterfaceTypeAttribute()]
[GuidAttribute("CE62717C-797D-445F-BC89-1D02C54CCF96")]
public interface IVsFinalTextChangeCommitEvents

[InterfaceTypeAttribute()]
[GuidAttribute(L"CE62717C-797D-445F-BC89-1D02C54CCF96")]
public interface class IVsFinalTextChangeCommitEvents

[<InterfaceTypeAttribute()>]
[<GuidAttribute("CE62717C-797D-445F-BC89-1D02C54CCF96")>]
type IVsFinalTextChangeCommitEvents =  interface end

public interface IVsFinalTextChangeCommitEvents

El tipo IVsFinalTextChangeCommitEvents expone los siguientes miembros.

Métodos

	Nombre	Descripción
	OnChangesCommitted	Notifica a clientes de gestos último de confirmación para desencadenar el evento y proporcionar el intervalo de texto cambiado.

Arriba

Comentarios

Los servicios u otros entidades que tienen control total sobre la experiencia de edición son el único cliente diseñado de esta interfaz.

Acciones compuestos son las acciones que se agrupan en una sola unidad de Deshacer/deRehacer . Cuando el editor o un cliente por editorial (por ejemplo, un servicio de lenguaje) desea crear una acción compuesto llama OpenCompoundAction y CloseCompoundAction alrededor alguna llamada hace para manipular texto. Cada acción compuesto contiene los gestos de confirmación que requieran el entorno desencadenar un evento de confirmación para cada; sin embargo, para una acción compuesto, el entorno desencadena sólo un evento confirmar. Este evento se desencadena en el gesto prioridad de confirmación o en el gesto último de confirmación. Por ejemplo, mediante Buscar y Reemplazar, un usuario reemplaza seis intervalos de texto inmediatamente. Cada uno de estos reemplazos es potencialmente un gesto de confirmación, pero esto es una acción compuesto, el entorno espera hasta el final de la operación de Buscar y de Reemplazar para desencadenar un único evento de confirmación llamando a OnChangesCommitted y pasando un valor de CCG_MASS_REPLACE para el parámetro de dwGestureFlags .

IVsFinalTextChangeCommitEvents está diseñado sólo para uso de los servicios u otros objetos que tienen control total sobre la edición. No se desencadena en respuesta a los comandos de Deshacer o de Rehacer , pero solo se desencadena para los búferes que tienen un administrador de Deshacer . Implementar IVsFinalTextChangeCommitEvents el lenguaje recibe la notificación cuando el usuario realiza acciones committable. Para obtener más información, vea ChangeCommitGestureFlags. En respuesta a estas acciones, el lenguaje puede tomar las medidas necesite, como cambiar el formato del texto que puede haber sido insertado. Estas acciones no pueden ser deshechos normalmente cuando se deshace el cambio de texto porque, en general, Deshacer quita el texto en cuestión. Por esta razón, el sistema de eventos de confirmación no responde a Deshacer/Rehacer. Los clientes que también desea seguir los eventos de Deshacer/deRehacer pueden utilizar los eventos del clúster del administrador de Deshacer para ello.

IVsPreliminaryTextChangeCommitEvents es muy similar a IVsFinalTextChangeCommitEvents. La única diferencia es que IVsPreliminaryTextChangeCommitEvents se desencadena por el entorno antes de IVsFinalTextChangeCommitEvents y antes de otros eventos, como cambie el formato la selección. Éste es asegurarse de que el texto en el búfer no obtiene dañado antes de llamar a IVsPreliminaryTextChangeCommitEvents. Debe implementar IVsFinalTextChangeCommitEvents o IVsPreliminaryTextChangeCommitEvents, pero no ambos.

Notas para los implementadores

Implemente IVsFinalTextChangeCommitEvents en el objeto de cliente para recibir notificación de los cambios en el objeto de búfer de texto, VsTextBuffer. Exponga esta interfaz al búfer de texto mediante la interfaz de IConnectionPointContainer en el objeto VsTextBuffer del búfer de texto. Para obtener más información, vea Cómo: Registrar eventos del búfer de texto con heredado API.

Vea también

Referencia

Microsoft.VisualStudio.TextManager.Interop (Espacio de nombres)