Partager via


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

Voir aussi

Compositions

Objets incorporés

ITfComposition

ITfComposition::GetRange

IUnknown

Plages

TF_SELECTION

Utilisation de Text Services Framework