Interface ITfRange (msctf.h)

Article
08/24/2023

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