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

Статья
08/26/2023

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

Синтаксис

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