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

Artículo
03/05/2024

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

Sintaxis

HRESULT GetProtected(
  long *pValue
);

Parámetros

pValue

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.
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.

Comentarios

En general, los métodos del Modelo de objetos de texto (TOM) que intentan cambiar el formato o el contenido de un rango producen 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 los controles de edición enriquecidos, los intentos de cambiar el texto protegido dan como resultado un código de notificación de EN_PROTECTED al creador del documento, que después puede rechazar o conceder permiso para el cambio. El creador es el cliente que creó un control de edición enriquecido 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