Interface ITfRange (msctf.h)
L’interface ITfRange est utilisée par les services de texte et les applications pour référencer et manipuler du texte dans un contexte donné. L’ID d’interface est IID_ITfRange.
Héritage
L’interface ITfRange hérite de l’interface IUnknown. ITfRange a également les types de membres suivants :
Méthodes
L’interface ITfRange a ces méthodes.
| ITfRange::AdjustForInsert La méthode ITfRange::AdjustForInsert développe ou contracte une plage de texte à ajuster pour l’insertion de texte. |
| ITfRange::Clone La méthode ITfRange::Clone duplique cette plage de texte. |
| ITfRange::Collapse La méthode ITfRange::Collapse efface la plage de texte en déplaçant son ancre de début et son ancre de fin à la même position. |
| ITfRange::CompareEnd La méthode ITfRange::CompareEnd compare la position d’ancrage de fin de cette plage de texte à une ancre dans une autre plage. |
| ITfRange::CompareStart La méthode ITfRange::CompareStart compare la position d’ancrage de début de cette plage de texte à une ancre dans une autre plage. |
| ITfRange::GetContext ITfRange::GetContext, méthode |
| ITfRange::GetEmbedded La méthode ITfRange::GetEmbedded obtient du contenu qui correspond à un caractère TS_CHAR_EMBEDDED dans le flux de texte. L’ancre de début de la plage de texte est positionnée juste avant le caractère qui vous intéresse. |
| ITfRange::GetFormattedText La méthode ITfRange::GetFormattedText obtient le contenu mis en forme contenu dans une plage de texte. Le contenu est empaqueté dans un objet qui prend en charge l’interface IDataObject. |
| ITfRange::GetGravity Méthode ITfRange::GetGravity |
| ITfRange::GetText La méthode ITfRange::GetText obtient le contenu couvert par cette plage de texte. |
| ITfRange::InsertEmbedded La méthode ITfRange::InsertEmbedded insère un objet à l’emplacement de l’ancre de début de la plage de texte. |
| ITfRange::IsEmpty La méthode ITfRange::IsEmpty vérifie que la plage de texte est vide, car les ancres de début et de fin occupent la même position. |
| ITfRange::IsequalEnd La méthode ITfRange::IsEqualStart vérifie que l’ancre de fin de cette plage de texte correspond à une ancre d’une autre plage spécifiée. |
| ITfRange::IsequalStart La méthode ITfRange::IsEqualStart vérifie que l’ancre de début de cette plage de texte correspond à une ancre d’une autre plage spécifiée. |
| ITfRange::SetGravity ITfRange::SetGravity, méthode |
| ITfRange::SetText La méthode ITfRange::SetText remplace le contenu couvert par la plage de texte. |
| ITfRange::ShiftEnd Méthode ITfRange::ShiftEnd |
| ITfRange::ShiftEndRegion Méthode ITfRange::ShiftEndRegion |
| ITfRange::ShiftEndToRange ITfRange::ShiftEndToRange, méthode |
| ITfRange::ShiftStart Méthode ITfRange::ShiftStart |
| ITfRange::ShiftStartRegion Méthode ITfRange::ShiftStartRegion |
| ITfRange::ShiftStartToRange Méthode ITfRange::ShiftStartToRange |
Notes
Le gestionnaire TSF implémente cette interface. Pour plus d’informations sur les plages, les ancres, les objets incorporés et d’autres propriétés de texte utilisées par TSF, consultez Plages, objets incorporés et autres rubriques dans Utilisation de Text Services Framework.
Exemples
Une fois qu’un objet de composition ITfComposition est instancié, un pointeur vers un pointeur d’interface ITfRange peut être obtenu en appelant la méthode ITfComposition::GetRange , comme indiqué dans l’exemple de code suivant.
HRESULT hr;
ITfComposition *pComposition;
ITfRange *pRange;
WCHAR *achBuffer[64]; // Buffer to receive text.
ULONG cch;
hr = pComposition->GetRange(&pRange);
if(SUCCEEDED(hr))
{
// Loop to scan text:
do
{
cch = ARRAYSIZE(achBuffer);
hr = pRange->GetText(ec, TF_TF_MOVESTART | TF_TF_IGNOREEND, achBuffer, cch, &cch);
if(SUCCEEDED(hr))
{
// Do something with the text.
pRange->Release();
}
}
while (cch == ARRAYSIZE(achBuffer));
pComposition->Release();
}
Un pointeur vers un objet ITfRange actuel peut être obtenu à partir de l’élément <range> de la structure TF_SELECTION .
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 |
| Composant redistribuable | TSF 1.0 sur Windows 2000 Professionnel |