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

Artigo
08/24/2023

Obtém um intervalo que abrange o texto que contém um valor não vazio para a propriedade .

Sintaxe

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

Parâmetros

[in] ec

Contém um cookie de edição que identifica o contexto de edição. Isso é obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] pRange

Ponteiro para uma interface ITfRange que contém o ponto para o qual obter o intervalo de propriedades. O ponto será a âncora inicial ou a âncora final desse intervalo, com base no valor de aPos.

[out] ppRange

Ponteiro para um ponteiro de interface ITfRange que recebe o objeto de intervalo solicitado.

[in] aPos

Contém um dos valores TfAnchor que especifica para qual âncora de pRange é usada como o ponto para obter o intervalo de propriedades.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	pRange não está acima ou adjacente à propriedade . ppRange recebe NULL.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_OUTOFMEMORY	Ocorreu uma falha de alocação de memória.
E_FAIL	Ocorreu um erro não especificado.
TF_E_NOLOCK	O contexto de edição identificado por ec não tem um bloqueio somente leitura ou leitura/gravação.

Comentários

Esse método obtém um intervalo de texto que contém um valor não vazio para a propriedade . Se a propriedade não tiver nenhum valor no ponto especificado, ppRange receberá NULL e o método retornará S_FALSE. No exemplo a seguir, se aPos contiver TF_ANCHOR_START, o intervalo retornado conterá "is". Se aPos contiver TF_ANCHOR_END, o método retornará S_FALSE porque a propriedade não existe no ponto final do intervalo.


COLOR: RRRRR   RR          GGGGGGGG
TEXT:  this &lt;a&gt;is som&lt;/a&gt;e colored text

Se aPos contiver TF_ANCHOR_START, esse método ignorará os intervalos de propriedades que terminam imediatamente antes da âncora inicial. Da mesma forma, se aPos contiver TF_ANCHOR_END, esse método ignorará os intervalos de propriedades que começam imediatamente após a âncora final. No exemplo a seguir, se aPos contiver TF_ANCHOR_START, o intervalo retornado conterá "colorido" e não "alguns" porque a propriedade de valor R termina no ponto de âncora inicial e a propriedade de valor G começa na âncora inicial. Se aPos contiver TF_ANCHOR_END, o intervalo retornado conterá "colorido" e não "texto".


COLOR:         RRRRR   GGGGGGGG    BBBB
TEXT:  this is some &lt;a&gt;colored &lt;/a&gt;text

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional