Interfaccia UndoContext

Articolo
10/30/2012

Rappresenta, come un'unica transazione, tutte le operazioni eseguite in tutti i documenti aperti partecipanti in Visual Studio.Se lo SetAborted il metodo viene richiamato, tutte le modifiche apportate dopo l'apertura dell'oggetto vengono rimossi.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
<GuidAttribute("D8DEC44D-CAF2-4B39-A539-B91AE921BA92")> _
Public Interface UndoContext

[GuidAttribute("D8DEC44D-CAF2-4B39-A539-B91AE921BA92")]
public interface UndoContext

[GuidAttribute(L"D8DEC44D-CAF2-4B39-A539-B91AE921BA92")]
public interface class UndoContext

[<GuidAttribute("D8DEC44D-CAF2-4B39-A539-B91AE921BA92")>]
type UndoContext =  interface end

public interface UndoContext

Il tipo UndoContext espone i seguenti membri.

Proprietà

	Nome	Descrizione
	DTE	Ottiene l'oggetto estensibilità di primo livello.
	IsAborted	Indica se UndoContext l'operazione dell'oggetto è stata interrotta da SetAborted metodo.
	IsOpen	Indica se un'operazione di annullamento è correntemente attive o se è aperta una soluzione.
	IsStrict	Indica se il collegamento di annullamento dello stack è rigido.
	Parent	Ottiene l'oggetto padre immediato di un oggetto UndoContext oggetto.

In alto

Metodi

	Nome	Descrizione
	Close	termina un'operazione di annullamento.
	Open	Avvia una nuova operazione di annullamento.
	SetAborted	Rimuove tutte le modifiche ai documenti aperti partecipanti da aprire UndoContext oggetto.

In alto

Note

UndoContext l'oggetto viene restituito da UndoContext proprietà di _DTE oggetto.È presente un servizio di annullamento globale in Visual Studio che viene aperto o chiuso.dopo UndoContext l'oggetto è aperto, tutti gli aggiornamenti effettuati ai documenti in Visual Studio può essere utilizzato (annullato) da una singola operazione di annullamento, SetAborted metodo, fino alla chiusura dell'oggetto.se SetAborted il metodo viene richiamato, tutte le modifiche apportate dopo l'apertura dell'oggetto vengono rimossi.

Per utilizzare UndoContext oggetto, aprirlo, apportare le modifiche di documento e quindi chiudere l'oggetto per finalizzare le modifiche.

Per annullare le modifiche, chiamare SetAborted metodo prima di chiudere UndoContext oggetto.Dopo la chiusura di UndoContext oggetto, ma non è più possibile annullare le modifiche.

[!NOTA]

prima di utilizzare UndoContext oggetto, verificare se è già aperto da un'operazione precedente.Se è già aperto, le modifiche verranno annullate in tutti i documenti partecipanti, con tutte le modifiche apportate poiché l'oggetto in primo luogo è stato aperto.se UndoContext l'oggetto è già aperto quando lo si seleziona, non viene chiuso, poiché il chiamante precedente nuovamente lo scopo di un'operazione di annullamento.Di conseguenza, non è necessario chiamare SetAborted quindi chiudere UndoContext oggetto a meno che originariamente non sia aperta.Chiudere il termine della sessione di modifica di testo nei documenti.

Esempi

Sub UndoContextExample()
   ' Before running, select text in an open document.
   Dim txtSel As TextSelection
   Dim strTS As String, boolWasOpen As Boolean
   txtSel = DTE.ActiveDocument.Selection
   strTS = txtSel.Text

   ' Check to see if UndoContext object is already open.
   If DTE.UndoContext.IsOpen = True Then
      boolWasOpen = True
   Else
      ' Open the UndoContext object to track changes.
      DTE.UndoContext.Open("RemoveNewLines", False)
   End If

   ' Perform search for newline characters and remove them.
   If strTS <> "" Then
      txtSel.Delete()
      strTS = Replace(strTS, vbNewLine, "", Compare:=vbTextCompare)
      txtSel.Insert(strTS)
   End If

   ' If UndoContext was already open, do not close it.
   If boolWasOpen = False Then
      ' Close the UndoContext object to commit the changes.
      DTE.UndoContext.Close()
   End If
End Sub

Vedere anche

Riferimenti

Spazio dei nomi EnvDTE

Condividi tramite