Compartir a través de


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

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

Consulte también

Composiciones

Objetos incrustados

ITextStoreAnchor

ITextStoreAnchor::InsertEmbedded

ITextStoreAnchor::RequestLock

ITextStoreAnchorSink::OnTextChange

Constantes de almacén de texto varios