IVsRunningDocTableEvents2 Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Реализует методы, активизируемые в ответ на изменения в документах, находящихся в таблице текущих документов (RDT).
public interface class IVsRunningDocTableEvents2 : Microsoft::VisualStudio::Shell::Interop::IVsRunningDocTableEvents
public interface class IVsRunningDocTableEvents2 : Microsoft::VisualStudio::Shell::Interop::IVsRunningDocTableEvents
__interface IVsRunningDocTableEvents2 : Microsoft::VisualStudio::Shell::Interop::IVsRunningDocTableEvents
[System.Runtime.InteropServices.Guid("15C7826F-443C-406D-98F8-55F6260669EC")]
[System.Runtime.InteropServices.InterfaceType(1)]
public interface IVsRunningDocTableEvents2 : Microsoft.VisualStudio.Shell.Interop.IVsRunningDocTableEvents
[<System.Runtime.InteropServices.Guid("15C7826F-443C-406D-98F8-55F6260669EC")>]
[<System.Runtime.InteropServices.InterfaceType(1)>]
type IVsRunningDocTableEvents2 = interface
interface IVsRunningDocTableEvents
Public Interface IVsRunningDocTableEvents2
Implements IVsRunningDocTableEvents
- Производный
- Атрибуты
- Реализации
Комментарии
IVsRunningDocTableEvents2Интерфейс указывается в вызове AdviseRunningDocTableEvents метода в IVsRunningDocumentTable интерфейсе.
Методы интерфейса используют файл cookie для представления клиента, запрашивающего уведомление. Используйте файл cookie в вызове UnadviseRunningDocTableEvents метода, когда пакет больше не желает прослушивать события РДТ.
Вам может потребоваться реализовать дополнительные интерфейсы для расширенного уведомления о событии:
Чтобы получить уведомление перед сохранением документа, реализуйте IVsRunningDocTableEvents3 интерфейс.
Чтобы получить уведомление перед применением первой блокировки документа (что дает возможность загрузить документ), реализуйте IVsRunningDocTableEvents4 интерфейс.
Примечания для тех, кто реализует этот метод
Реализуйте этот интерфейс в пакетах, чтобы получить события о состоянии документов в РДТ. Обратите внимание, что этот интерфейс является производным от IVsRunningDocTableEvents интерфейса и должен также реализовать все методы в этом интерфейсе.
Параметр cookie, передаваемый всем методам в этом интерфейсе, представляет документ, затронутый определенным событием. Этот файл cookie имеет то же значение, что FindAndLockDocument(UInt32, String, IVsHierarchy, UInt32, IntPtr, UInt32) и RegisterAndLockDocument(UInt32, String, IVsHierarchy, UInt32, IntPtr, UInt32) методы или в IVsRunningDocumentTable интерфейсе.
Примечания для тех, кто вызывает этот метод
Среда вызывает этот интерфейс при возникновении конкретных событий. Этот интерфейс предоставляет доступ к дополнительным сведениям, чем IVsRunningDocTableEvents при переименовании документа.
Методы
| OnAfterAttributeChange(UInt32, UInt32) |
Вызывается после изменения в атрибуте документа в таблице выполняющихся документов (RDT). |
| OnAfterAttributeChangeEx(UInt32, UInt32, IVsHierarchy, UInt32, String, IVsHierarchy, UInt32, String) |
Вызывается после изменения атрибута документа. Это расширенная версия метода OnAfterAttributeChange(UInt32, UInt32). |
| OnAfterDocumentWindowHide(UInt32, IVsWindowFrame) |
Вызывается после скрытия окна документа. |
| OnAfterFirstDocumentLock(UInt32, UInt32, UInt32, UInt32) |
Вызывается после первой блокировки указанного типа в заданном документе в таблице выполняющихся документов (RDT). |
| OnAfterSave(UInt32) |
Вызывается после сохранения документа, находящегося в таблице текущих документов (RDT). |
| OnBeforeDocumentWindowShow(UInt32, Int32, IVsWindowFrame) |
Вызывается перед отображением окна документа. |
| OnBeforeLastDocumentUnlock(UInt32, UInt32, UInt32, UInt32) |
Вызывается перед отключением последней блокировки указанного типа в заданном документе в таблице выполняющихся документов (RDT). |