Interfaccia IVsFinalTextChangeCommitEvents
Notifica ai client dell'ultimo spostamento di commit per attivare l'evento e fornisce l'intervallo di testo modificato.
Spazio dei nomi: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)
Sintassi
'Dichiarazione
<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
Il tipo IVsFinalTextChangeCommitEvents espone i seguenti membri.
Metodi
| Nome | Descrizione | |
|---|---|---|
.gif "Metodo pubblico") |
OnChangesCommitted | Notifica ai client dell'ultimo spostamento di commit per attivare l'evento e specificare l'intervallo di testo modificato. |
In alto
Note
I servizi di linguaggio o altre parti che hanno controllo totale sulle operazioni di modifica sono l'unico client previsto dell'interfaccia.
le azioni composte sono azioni che sono raggruppate in un singolo AnnullaoRipetizione unità. Quando l'editor o un client dell'editor, ad esempio servizio di linguaggio) desidera creare un'azione composta chiama OpenCompoundAction e CloseCompoundAction per racchiudere le chiamate adottato per modificare il testo. Ogni azione composta contiene i movimenti di commit che richiederebbero l'ambiente di generare un evento di commit per ogni oggetto; tuttavia, per un'azione composta, viene generato un evento solo di commit. Questo evento viene generato sul movimento di commit priorità più elevata o nell'ultimo spostamento di commit. Ad esempio, tramite Ricerca e di sostituzione, un utente sostituisce sei intervalli di testo immediatamente. Ognuna di queste sostituzioni è potenzialmente un movimento di commit, ma poiché questa è un'azione composta, resta in attesa dell'ambiente fino al termine di OnChangesCommitted e CCG_MASS_REPLACE operazione per generare un solo evento di commit chiamando dwGestureFlags e passando un valore di di Ricerca per di sostituzione parametro.
IVsFinalTextChangeCommitEvents è destinata solo ai servizi di linguaggio o di altri oggetti che dispongono di controllo completo della modifica. Non viene generato in risposta a Annulla o Ripetizione controlli, ma solo generato per i buffer che hanno Annulla amministratore. Distribuzione IVsFinalTextChangeCommitEvents il linguaggio riceve una notifica quando l'utente esegue alcune azioni committable. Per ulteriori informazioni, vedere ChangeCommitGestureFlags. In risposta a queste azioni, il linguaggio possibile eseguire qualsiasi azione necessaria, come la formattazione del testo che è possibile inserire. Queste azioni non possono essere annullate in genere quando la modifica di testo viene annullato perché, in genere, Annulla rimuove il testo in questione. Per questo motivo, il sistema di eventi di commit non risponde a AnnullaoRipetizione. Client che si desidera tenere traccia AnnullaoRipetizione gli eventi possono utilizzare Annulla eventi del cluster di amministratore a tale scopo.
IVsPreliminaryTextChangeCommitEvents è molto simile a IVsFinalTextChangeCommitEvents. L'unica differenza è quella IVsPreliminaryTextChangeCommitEvents ottiene generato prima dell'ambiente IVsFinalTextChangeCommitEvents e prima di altri eventi, ad esempio riformattare la selezione. Ciò consente di garantire che il testo nel buffer non viene danneggiato prima di chiamare IVsPreliminaryTextChangeCommitEvents. È necessario implementare uno IVsFinalTextChangeCommitEvents o IVsPreliminaryTextChangeCommitEvents, ma non entrambi.
Note per gli implementatori
Utilizzo IVsFinalTextChangeCommitEvents nell'oggetto client alla notifica di ricezione delle modifiche al buffer di testo, VsTextBuffer. Esporre questa interfaccia nel buffer di testo mediante il IConnectionPointContainer collegare sull'oggetto del buffer di testo VsTextBuffer . Per ulteriori informazioni, vedere Procedura: Registrazione di eventi del buffer di testo con le API legacy