ITfRange-Schnittstelle (msctf.h)

Artikel
08/24/2023

Die ITfRange-Schnittstelle wird von Textdiensten und -anwendungen verwendet, um auf Text in einem bestimmten Kontext zu verweisen und zu bearbeiten. Die Schnittstellen-ID ist IID_ITfRange.

Vererbung

Die ITfRange-Schnittstelle erbt von der IUnknown-Schnittstelle . ITfRange verfügt auch über folgende Arten von Membern:

Methoden

Die ITfRange-Schnittstelle verfügt über diese Methoden.


ITfRange::AdjustForInsert Die ITfRange::AdjustForInsert-Methode erweitert oder ordnet einen Textbereich an, der für das Einfügen von Text angepasst werden soll.
ITfRange::Clone Die ITfRange::Clone-Methode dupliziert diesen Textbereich.
ITfRange::Collapse Die ITfRange::Collapse-Methode löscht den Textbereich, indem der Start- und Endanker an die gleiche Position verschoben wird.
ITfRange::CompareEnd Die ITfRange::CompareEnd-Methode vergleicht die Endankerposition dieses Textbereichs mit einem Anker in einem anderen Bereich.
ITfRange::CompareStart Die ITfRange::CompareStart-Methode vergleicht die Startankerposition dieses Textbereichs mit einem Anker in einem anderen Bereich.
ITfRange::GetContext ITfRange::GetContext-Methode
ITfRange::GetEmbedded Die ITfRange::GetEmbedded-Methode ruft Inhalte ab, die einem TS_CHAR_EMBEDDED Zeichen im Textstream entsprechen. Der Startanker des Textbereichs befindet sich unmittelbar vor dem interessanten Zeichen.
ITfRange::GetFormattedText Die ITfRange::GetFormattedText-Methode ruft formatierten Inhalt ab, der in einem Textbereich enthalten ist. Der Inhalt wird in einem Objekt verpackt, das die IDataObject-Schnittstelle unterstützt.
ITfRange::GetGravity ITfRange::GetGravity-Methode
ITfRange::GetText Die ITfRange::GetText-Methode ruft den Inhalt ab, der von diesem Textbereich abgedeckt wird.
ITfRange::InsertEmbedded Die ITfRange::InsertEmbedded-Methode fügt ein Objekt an der Position des Startankers des Textbereichs ein.
ITfRange::IsEmpty Die ITfRange::IsEmpty-Methode überprüft, ob der Textbereich leer ist, da die Start- und Endanker die gleiche Position einnehmen.
ITfRange::IsEqualEnd Die ITfRange::IsEqualStart-Methode überprüft, ob der Endanker dieses Textbereichs mit einem Anker eines anderen angegebenen Bereichs übereinstimmt.
ITfRange::IsEqualStart Die ITfRange::IsEqualStart-Methode überprüft, ob der Startanker dieses Textbereichs einem Anker eines anderen angegebenen Bereichs entspricht.
ITfRange::SetGravity ITfRange::SetGravity-Methode
ITfRange::SetText Die ITfRange::SetText-Methode ersetzt den Inhalt, der durch den Textbereich abgedeckt wird.
ITfRange::ShiftEnd ITfRange::ShiftEnd-Methode
ITfRange::ShiftEndRegion ITfRange::ShiftEndRegion-Methode
ITfRange::ShiftEndToRange ITfRange::ShiftEndToRange-Methode
ITfRange::ShiftStart ITfRange::ShiftStart-Methode
ITfRange::ShiftStartRegion ITfRange::ShiftStartRegion-Methode
ITfRange::ShiftStartToRange ITfRange::ShiftStartToRange-Methode

Hinweise

Diese Schnittstelle wird vom TSF-Manager implementiert. Weitere Informationen zu Bereichen, Ankern, eingebetteten Objekten und anderen Texteigenschaften, die von TSF verwendet werden, finden Sie unter Bereiche, eingebettete Objekte und andere Themen in Using Text Services Framework.

Beispiele

Sobald ein ITfComposition-Kompositionsobjekt instanziiert wurde, kann ein Zeiger auf einen ITfRange-Schnittstellenzeiger abgerufen werden, indem die ITfComposition::GetRange-Methode aufgerufen wird, wie im folgenden Codebeispiel gezeigt.


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();
}

Ein Zeiger auf ein aktuelles ITfRange-Objekt kann aus dem <range-Element> der TF_SELECTION-Struktur abgerufen werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional