Partager via


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.

Valeur Description
S_OK
La méthode a réussi.
S_FALSE
pRange n’est pas over ou adjacent à la propriété . ppRange reçoit la valeur NULL.
E_INVALIDARG
Un ou plusieurs paramètres ne sont pas valides.
E_OUTOFMEMORY
Un échec d’allocation de mémoire s’est produit.
E_FAIL
Une erreur non spécifiée s'est produite.
TF_E_NOLOCK
Le contexte de modification identifié par ec n’a pas de verrou en lecture seule ou en lecture/écriture.

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

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête msctf.h
DLL Msctf.dll
Composant redistribuable TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange

TfAnchor