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 |
|---|---|
|
La méthode a réussi. |
|
pRange n’est pas over ou adjacent à la propriété . ppRange reçoit la valeur NULL. |
|
Un ou plusieurs paramètres ne sont pas valides. |
|
Un échec d’allocation de mémoire s’est produit. |
|
Une erreur non spécifiée s'est produite. |
|
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 |