Compartir a través de


Método ITfProperty::FindRange (msctf.h)

Obtiene un intervalo que cubre el texto que contiene un valor no vacío para la propiedad .

Sintaxis

HRESULT FindRange(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pRange,
  [out] ITfRange     **ppRange,
  [in]  TfAnchor     aPos
);

Parámetros

[in] ec

Contiene una cookie de edición que identifica el contexto de edición. Esto se obtiene de ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] pRange

Puntero a una interfaz ITfRange que contiene el punto para obtener el intervalo de propiedades. El punto será el delimitador inicial o final de este intervalo, en función del valor de aPos.

[out] ppRange

Puntero a un puntero de interfaz ITfRange que recibe el objeto de intervalo solicitado.

[in] aPos

Contiene uno de los valores tfAnchor para los que se especifica el delimitador de pRange como punto para obtener el intervalo de propiedades.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
Método realizado correctamente.
S_FALSE
pRange no está sobreajuste ni adyacente a la propiedad . ppRange recibe NULL.
E_INVALIDARG
Uno o varios parámetros no son válidos.
E_OUTOFMEMORY
Error de asignación de memoria.
E_FAIL
Se ha producido un error no especificado.
TF_E_NOLOCK
El contexto de edición identificado por ec no tiene un bloqueo de solo lectura o de lectura y escritura.

Comentarios

Este método obtiene un intervalo de texto que contiene un valor no vacío para la propiedad . Si la propiedad no tiene ningún valor en el punto especificado, ppRange recibe NULL y el método devuelve S_FALSE. En el ejemplo siguiente, si aPos contiene TF_ANCHOR_START, el intervalo devuelto contendrá "is". Si aPos contiene TF_ANCHOR_END, el método devolvería S_FALSE porque la propiedad no existe en el punto final del intervalo.


COLOR: RRRRR   RR          GGGGGGGG
TEXT:  this <a>is som</a>e colored text

Si aPos contiene TF_ANCHOR_START, este método omite los intervalos de propiedades que terminan inmediatamente antes del delimitador inicial. Del mismo modo, si aPos contiene TF_ANCHOR_END, este método omite los intervalos de propiedades que comienzan inmediatamente después del delimitador final. En el ejemplo siguiente, si aPos contiene TF_ANCHOR_START, el intervalo devuelto contendrá "colored" y no "some" porque la propiedad de valor de R termina en el punto de anclaje inicial y la propiedad de valor G comienza en el delimitador inicial. Si aPos contiene TF_ANCHOR_END, el intervalo devuelto contendrá "colored" y no "text".


COLOR:         RRRRR   GGGGGGGG    BBBB
TEXT:  this is some <a>colored </a>text

Requisitos

   
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

Consulte también

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange

TfAnchor