Método ITextRange::SetText (tom.h)

Artículo
08/26/2023

Establece el texto de este intervalo.

Sintaxis

HRESULT SetText(
  [in] BSTR bstr
);

Parámetros

[in] bstr

Tipo: BSTR

Texto que reemplaza el texto actual de este intervalo. Si es null, se elimina el texto actual.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor 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. 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_ACCESSDENIED	El texto está protegido por escritura.
E_INVALIDARG	bstr es null.
E_OUTOFMEMORY	Memoria insuficiente

Comentarios

ITextRange::SetText reemplaza el texto del intervalo por el nuevo texto. Por el contrario, TypeText reemplaza la selección por el texto bstr y deja la selección como punto de inserción justo después del texto insertado, como si hubiera escrito el texto. Para ver el comportamiento de la selección de la interfaz de usuario, consulte TypeText.

Si, después de llamar a ITextRange::SetText, llamas a ITextRange::GetText, devuelves el mismo texto que estableces con el método ITextRange::SetText (a menos que algún otro intervalo haya cambiado ese texto entre las llamadas).

Requisitos


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