Интерфейс ITextDocument (tom.h)

Статья
08/26/2023

Интерфейс ITextDocument — это интерфейс верхнего уровня текстовой объектной модели (TOM), который извлекает активные объекты выделения и диапазона для любой истории в документе, будь то активной или нет. Это позволяет приложению:

Открытие и сохранение документов.
Управление поведением отмены и обновлением экрана.
Поиск диапазона из положения экрана.
Получение перечислителя истории ITextStoryRanges .

Момент реализации

Приложения обычно не реализуют интерфейс ITextDocument . Текстовые решения Майкрософт, такие как элементы управления расширенным редактированием, реализуют ITextDocument как часть реализации TOM.

Назначение

Приложения могут получать указатель ITextDocument из элемента управления с расширенными возможностями редактирования. Для этого отправьте сообщение EM_GETOLEINTERFACE , чтобы получить объект IRichEditOle из элемента управления с расширенным редактированием. Затем вызовите метод IUnknown::QueryInterface объекта, чтобы получить указатель ITextDocument .

Наследование

Интерфейс ITextDocument наследуется от интерфейса IUnknown . ITextDocument также имеет следующие типы элементов:

Методы

Интерфейс ITextDocument содержит следующие методы.


ITextDocument::BeginEditCollection Включает изменение коллекции (также называется отменой группировки).
ITextDocument::EndEditCollection Отключает изменение коллекции (также называется отменой группировки).
ITextDocument::Freeze Увеличивает число заморозок.
ITextDocument::GetDefaultTabStop Возвращает ширину вкладки по умолчанию.
ITextDocument::GetName Возвращает имя файла этого документа. Это свойство ITextDocument по умолчанию.
ITextDocument::GetSaved Возвращает значение, указывающее, были ли внесены изменения с момента последнего сохранения файла.
ITextDocument::GetSelection Возвращает активный выделенный фрагмент. (ITextDocument.GetSelection)
ITextDocument::GetStoryCount Возвращает количество историй в этом документе.
ITextDocument::GetStoryRanges Возвращает объект коллекции историй, используемый для перечисления историй в документе.
ITextDocument::New Открывает новый документ.
ITextDocument::Open Открывает указанный документ. Существуют параметры для указания привилегий доступа и общего доступа, создания и преобразования файла, а также кодовой страницы для файла.
ITextDocument::Range Извлекает объект текстового диапазона для указанного диапазона содержимого в активной истории документа.
ITextDocument::RangeFromPoint Извлекает диапазон для содержимого в указанной точке экрана или ближе к ней.
ITextDocument::Redo Выполняет указанное количество операций повтора.
ITextDocument::Save Сохраняет документ.
ITextDocument::SetDefaultTabStop Задает позицию табуляции по умолчанию, которая используется, если вкладка не существует за пределами текущей позиции отображения.
ITextDocument::SetSaved Задает свойство Сохраненный документ.
ITextDocument::Undo Выполняет указанное количество операций отмены.
ITextDocument::Unfreeze Уменьшает число заморозок.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	tom.h

См. также раздел

Основные понятия

Текстовая объектная модель

Использование текстовой объектной модели