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

Article
08/24/2023

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 &lt;a&gt;is som&lt;/a&gt;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 &lt;a&gt;colored &lt;/a&gt;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