UndoContext الواجهة

  • مقالة

Represents, كـ a مفرد عملية, الجميع العمليات performed تشغيل الجميع participating فتح مستندات في Visual Studio. إذا كان له SetAbortedأسلوب هو استدعاء، تكون كافة التغييرات التي أجريت منذ فتح الكائن dهوcarded.

مساحة الاسم:  EnvDTE
التجميع:  EnvDTE (في EnvDTE.dll)

بناء الجملة

'إقرار
<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

ملاحظات

The UndoContext كائن هو returned بواسطة the UndoContext خاصية of the _DTE كائن. There هو فقط واحد عمومي مرحلة التراجع الخدمة في Visual Studio that هو either فتح أو مغلق. بعد the UndoContext كائن هو opened, الجميع تحديثات made إلى مستندات في Visual Studio can be reversed (undone) بواسطة a مفرد مرحلة التراجع إجراء, the SetAborted أسلوب, until the كائن هو مغلق. إذا SetAbortedأسلوب هو استدعاء، تكون كافة التغييرات التي أجريت منذ فتح الكائن dهوcarded.

إلى استخدم the UndoContext كائن, فتح it, make مستند التغييرات, و then يغلق the كائن إلى finalize the التغييرات.

إلى تجاهل the التغييرات, يتصل the SetAborted أسلوب قبل closing the UndoContext كائن. بعد you يغلق UndoContext كائن, you can لا longer مرحلة التراجع the التغييرات.

ملاحظة

قبل using the UndoContext كائن, فحص إلى see if it هو already فتح من a السابق تشغيل. إذا كان ذلك هو مفتوحاً بالفعل، ثم يتم التراجع عن التغييرات في كافة المستندات المشاركة، بالإضافة إلى كافة التغييرات التي تم إنجازه منذ أن تم فتح الكائن لأول مرة. If the UndoContext كائن هو already فتح when you فحص it, do not يغلق it, because the السابق caller still يتطلب it for an مرحلة التراجع تشغيل. Consequently, you should not يتصل SetAborted و then يغلق the UndoContext كائن unless you originally opened it. يغلق it بعد you are done changing نص في مستندات.

أمثلة

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

راجع أيضًَا

المرجع

UndoContext الأعضاء

EnvDTE مساحة الاسم