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

Obtient une plage qui couvre le texte qui contient une valeur non vide pour la propriété.

Syntaxe

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

Paramètres

[in] ec

Contient un cookie de modification qui identifie le contexte de modification. Elle est obtenue à partir de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] pRange

Pointeur vers une interface ITfRange qui contient le point pour lequel obtenir la plage de propriétés. Le point sera l’ancre de début ou l’ancre de fin de cette plage, en fonction de la valeur de aPos.

[out] ppRange

Pointeur vers un pointeur d’interface ITfRange qui reçoit l’objet de plage demandé.

[in] aPos

Contient l’une des valeurs TfAnchor qui spécifie quelle ancre de pRange est utilisée comme point pour obtenir la plage de propriétés.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

Cette méthode obtient une plage de texte qui contient une valeur non vide pour la propriété. Si la propriété n’a aucune valeur au point spécifié, ppRange reçoit NULL et la méthode retourne S_FALSE. Dans l’exemple suivant, si aPos contient TF_ANCHOR_START, la plage retournée contient « is ». Si aPos contient TF_ANCHOR_END, la méthode retourne S_FALSE, car la propriété n’existe pas au point de fin de la plage.

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

Si aPos contient TF_ANCHOR_START, cette méthode ignore les plages de propriétés qui se terminent immédiatement avant l’ancre de début. De même, si aPos contient TF_ANCHOR_END, cette méthode ignore les plages de propriétés qui commencent immédiatement après l’ancre de fin. Dans l’exemple suivant, si aPos contient TF_ANCHOR_START, la plage retournée contient « colored » et non « some », car la propriété R value se termine au point d’ancrage de début et la propriété valeur G commence à l’ancre de début. Si aPos contient TF_ANCHOR_END, la plage retournée contient « colored » et non « text ».

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

Spécifications

Voir aussi

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange

TfAnchor