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

Artículo
08/24/2023

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 &lt;a&gt;is som&lt;/a&gt;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 &lt;a&gt;colored &lt;/a&gt;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