Объекты документов применяются для представления в интегрированной среде открытых документов. Для сравнения этой абстракции с той, которую предоставляет объект Window: объект Window используется для представления физических аспектов пользовательского интерфейса окна документа, в то время как объект Document служит для представления физического документа, который отображается внутри окна документа.
Документ может быть визуальным конструктором (таким как визуальный конструктор Windows Forms), либо он может быть текстовым документом (таким как ознакомительный файл readme или файл с кодом на языке С#, открытый в редакторе).
Точно так, как вы получаете список всех открытых окон при помощи коллекции DTE. Windows, точно так же вы можете использовать и коллекцию DTE. Documents для получения списка всех открытых документов:
Dim documents As Documents = DTE. Documents
Коллекция Documents индексирована по свойству Name документа, которое является именем файла документа (без информации о пути). Это облегчает быстрое получение экземпляра Document:
Dim documents As Documents = DTE. Documents
Dim readme As Document = documents. Item("ReadMe. txt")
При помощи объекта Document вы можете делать следующее:
□ закрыть документ (и по желанию сохранить изменения);
□ получить имя файла и путь к документу;
□ определить, был ли документ модифицирован с момента последнего его сохранения;
□ определить, что в данный момент выделено в документе;
□ получить экземпляр Proj ectltem, представляющий элемент проекта, который связан с документом;
□ читать и редактировать содержимое текстовых документов.
В табл. 3 содержатся описания членов объекта Document.