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

Статья
08/26/2023

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

Синтаксис

HRESULT SetProtected(
  [in] long Value
);

Параметры

[in] Value

Тип: long

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

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

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

Тип: HRESULT

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

Код возврата	Описание
E_INVALIDARG	Недопустимый аргумент.
CO_E_RELEASED	Объект font присоединяется к удаленному диапазону.
E_ACCESSDENIED	Доступ на запись запрещен.
E_OUTOFMEMORY	Недостаточно памяти.

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

Требования

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