Поделиться через


Метод ITextFont::GetProtected (tom.h)

Возвращает значение, определяющее, защищены ли символы от попыток их изменения.

Синтаксис

HRESULT GetProtected(
  long *pValue
);

Параметры

pValue

Тип: long*

Значение tomBool , которое может быть одним из следующих значений.

Значение Значение
tomTrue Символы защищены.
tomFalse Символы не защищены.
tomUndefined Свойство Protected не определено.

Возвращаемое значение

Тип: HRESULT

Если метод завершается успешно, он возвращает S_OK. Если метод завершается сбоем, он возвращает один из следующих кодов com-ошибок. Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.

Код возврата Описание
E_INVALIDARG
Недопустимый аргумент.
CO_E_RELEASED
Объект шрифта прикрепляется к удаленному диапазону.

Комментарии

Как правило, методы текстовой объектной модели (TOM), которые пытаются изменить форматирование или содержимое диапазона, не E_ACCESSDENIED , если какая-либо часть этого диапазона защищена или документ доступен только для чтения. Чтобы внести изменения в защищенный текст, клиент TOM должен попытаться отключить защиту измененного текста. Владелец документа может разрешить это. Например, в расширенных элементах управления редактированием попытки изменить защищенный текст приводят к EN_PROTECTED код уведомления создателю документа, который затем может отказаться или предоставить разрешение на изменение. Создателем является клиент, создавший оконный элемент управления полнофункционированным редактированием с помощью функции CreateWindow или объекта ITextHost , который вызвал функцию CreateTextServices для создания элемента управления полнофункционированным редактированием без окон.

Требования

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

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

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

CreateTextServices

CreateWindow

EN_PROTECTED

ITextFont

Другие ресурсы

Справочные материалы

SetProtected

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