Método ITfRange::AdjustForInsert (msctf.h)

Artículo
03/05/2024

El método ITfRange::AdjustForInsert expande o contrae un intervalo de texto para ajustarse a la inserción de texto.

Sintaxis

HRESULT AdjustForInsert(
  [in]  TfEditCookie ec,
  [in]  ULONG        cchInsert,
  [out] BOOL         *pfInsertOk
);

Parámetros

[in] ec

Edite la cookie obtenida de ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] cchInsert

Recuento de caracteres del texto insertado. Este recuento se usa en una llamada futura a ITfRange::SetText. Si se desconoce el recuento de caracteres, se puede usar 0.

[out] pfInsertOk

Puntero a una marca que indica si el propietario del contexto aceptará (TRUE) o rechazará (FALSE) la inserción.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_FAIL	Error en el método.
E_INVALIDARG	Uno o varios parámetros no son válidos.
E_NOTIMPL	La aplicación no pudo reemplazar la selección.
TF_E_NOLOCK	El valor del parámetro ec es una cookie no válida o el autor de la llamada no tiene un bloqueo de solo lectura.

Comentarios

Este método se debe usar para preparar un intervalo para iniciar una nueva composición, antes de comenzar la edición. Solo se debe usar cuando el texto no se inserta en la selección actual. ITFInsertAtSelection:InsertTextAtSelection o ITfInsertAtSelection::InsertEmbeddedAtSelection son los métodos correctos que se usarán cuando se inserta texto en la selección actual.

El propietario del contexto puede usar este método para conservar el comportamiento y ayudar a mantener una experiencia de usuario coherente. Por ejemplo, se pueden conservar determinados caracteres u objetos en el contexto de las modificaciones, o se puede admitir el sobrestipado.

Este método no es necesario al modificar una composición existente. Es aceptable llamar a ITfRange::SetText directamente para modificar el texto especificado anteriormente por el autor de la llamada.

Al salir, si *pfInsertOk está establecido en FALSE, es probable que se produzca un error en una llamada futura a ITfRange::SetText o ITfRange::InsertEmbedded con este intervalo. De lo contrario, *pfInsertOk se establecerá en TRUE y el delimitador inicial o final del intervalo se puede cambiar a discreción del propietario del contexto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional