Método ITextFont::SetProtected (tom.h)

Artículo
03/02/2024

Establece si los caracteres están protegidos contra intentos de modificarlos.

Sintaxis

HRESULT SetProtected(
  [in] long Value
);

Parámetros

[in] Value

Tipo: long

Un valor tomBool que puede ser uno de los siguientes.

Valor	Significado
tomTrue	Los caracteres están protegidos.
tomFalse	Los caracteres no están protegidos.
tomToggle	Alterne el estado de la propiedad Protected.
tomUndefined	La propiedad Protected no está definida.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve uno de los siguientes códigos de error COM. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
E_INVALIDARG	Argumento no válido.
CO_E_RELEASED	El objeto de fuente se adjunta a un intervalo que se ha eliminado.
E_ACCESSDENIED	Se deniega el acceso de escritura.
E_OUTOFMEMORY	Memoria insuficiente.

Comentarios

En general, los métodos Text Object Model (TOM) que intentan cambiar el formato o el contenido de un intervalo producirán un error con E_ACCESSDENIED si alguna parte de ese intervalo está protegida o si el documento es de solo lectura. Para realizar un cambio en el texto protegido, el cliente TOM debe intentar desactivar la protección del texto que se va a modificar. El propietario del documento puede permitir que esto suceda. Por ejemplo, en controles de edición enriquecidos, los intentos de cambiar el texto protegido dan como resultado un código de notificación EN_PROTECTED al creador del documento, que luego puede rechazar o conceder permiso para el cambio. El creador es el cliente que creó un control de edición enriquecida con ventanas a través de la función CreateWindow o el objeto ITextHost que llamó a la función CreateTextServices para crear un control de edición enriquecida sin ventanas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tom.h
Archivo DLL	Msftedit.dll