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

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.

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 <a>is som</a>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 <a>colored </a>text

Requisitos

Confira também

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange

TfAnchor