Método ITextStoreAnchor::SetText (textstor.h)

Artículo
03/13/2024

El método ITextStoreAnchor::SetText establece la selección de texto entre dos ubicaciones de anclaje proporcionadas.

Sintaxis

HRESULT SetText(
  [in] DWORD       dwFlags,
  [in] IAnchor     *paStart,
  [in] IAnchor     *paEnd,
  [in] const WCHAR *pchText,
  [in] ULONG       cch
);

Parámetros

[in] dwFlags

Si se establece en el valor de TS_ST_CORRECTION, el texto es una transformación (corrección) del contenido existente y se conserva cualquier información especial de marcado de texto (metadatos), como .wav datos de archivo o un identificador de idioma. El cliente define el tipo de información de marcado que se va a conservar.

[in] paStart

Puntero al delimitador al principio del intervalo de texto que se va a reemplazar.

[in] paEnd

Puntero al delimitador al final del intervalo de texto que se va a reemplazar. Siempre debe seguir o estar en la misma posición que paStart.

[in] pchText

Puntero al texto de reemplazo. La cadena de texto no tiene que terminar en NULL , porque el recuento de caracteres de texto se especifica en el parámetro cch .

[in] cch

Especifica el número de caracteres del texto de reemplazo.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_FAIL	El método no pudo crear una instancia de uno de los anclajes paStart o paEnd.
TS_E_INVALIDPOS	La ubicación de paStart o paEnd está fuera del texto del documento.
TS_E_NOLOCK	El autor de la llamada no tiene un bloqueo de lectura y escritura.
TS_E_READONLY	El documento es de solo lectura. No se puede modificar el contenido.
TS_E_REGION	Se intentó modificar el texto a través de un límite de región.

Comentarios

Las aplicaciones deben iniciar primero una composición mediante ITextStoreAnchor::InsertTextAtSelection. ITextStoreAnchor::SetText solo se debe usar dentro de una composición existente. Si no hay ninguna composición activa en el momento en que se llama a SetText , el administrador de TSF crea una composición que dura lo suficientemente larga como para ajustar la llamada a SetText.

Los llamadores deben contener un bloqueo de escritura obtenido a través de ITextStoreAnchor::RequestLock. De lo contrario, se producirá un error en ITextStoreAnchor::SetText con TS_E_NOLOCK.

Si paStart se encuentra en la misma ubicación que paEnd, la operación es una inserción y no se quitará ningún texto existente.

TS_CHAR_EMBEDDED no se puede pasar a este método. En el caso de los objetos incrustados, use ITextStoreAnchor::InsertEmbedded en su lugar.

Este método producirá un error si el intervalo de texto reemplazado cubre cualquier límite de región. En su lugar, los autores de llamadas deben realizar varias llamadas al método , una para cada región.

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	textstor.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional