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 |
|---|---|
|
Método realizado correctamente. |
|
pRange no está sobreajuste ni adyacente a la propiedad . ppRange recibe NULL. |
|
Uno o varios parámetros no son válidos. |
|
Error de asignación de memoria. |
|
Se ha producido un error no especificado. |
|
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 |