Interfaccia ITfRange (msctf.h)

Articolo
03/08/2023

L'interfaccia ITfRange viene usata dai servizi di testo e dalle applicazioni per fare riferimento e modificare il testo all'interno di un determinato contesto. L'ID interfaccia è IID_ITfRange.

Ereditarietà

L'interfaccia ITfRange eredita dall'interfaccia IUnknown . ITfRange include anche questi tipi di membri:

Metodi

L'interfaccia ITfRange include questi metodi.


ITfRange::AdjustForInsert Il metodo ITfRange::AdjustForInsert espande o crea un intervallo di testo da modificare per l'inserimento di testo.
ITfRange::Clone Il metodo ITfRange::Clone duplica questo intervallo di testo.
ITfRange::Collapse Il metodo ITfRange::Collapse cancella l'intervallo di testo spostando l'ancoraggio iniziale e l'ancoraggio alla stessa posizione.
ITfRange::CompareEnd Il metodo ITfRange::CompareEnd confronta la posizione di ancoraggio finale di questo intervallo di testo a un ancoraggio in un altro intervallo.
ITfRange::CompareStart Il metodo ITfRange::CompareStart confronta la posizione di ancoraggio iniziale di questo intervallo di testo a un ancoraggio in un altro intervallo.
ITfRange::GetContext Metodo ITfRange::GetContext
ITfRange::GetEmbedded Il metodo ITfRange::GetEmbedded ottiene contenuto che corrisponde a un carattere TS_CHAR_EMBEDDED nel flusso di testo. L'ancoraggio iniziale dell'intervallo di testo viene posizionato appena prima del carattere di interesse.
ITfRange::GetFormattedText Il metodo ITfRange::GetFormattedText ottiene contenuto formattato contenuto contenuto in un intervallo di testo. Il contenuto viene pacchetto in un oggetto che supporta l'interfaccia IDataObject.
ITfRange::GetGravity Metodo ITfRange::GetGravity
ITfRange::GetText Il metodo ITfRange::GetText ottiene il contenuto coperto da questo intervallo di testo.
ITfRange::InsertEmbedded Il metodo ITfRange::InsertEmbedded inserisce un oggetto nella posizione dell'ancoraggio iniziale dell'intervallo di testo.
ITfRange::IsEmpty Il metodo ITfRange::IsEmpty verifica che l'intervallo di testo sia vuoto perché gli ancoraggi iniziale e finale occupano la stessa posizione.
ITfRange::IsEqualEnd Il metodo ITfRange::IsEqualStart verifica che l'ancoraggio finale di questo intervallo di testo corrisponda a un ancoraggio di un altro intervallo specificato.
ITfRange::IsEqualStart Il metodo ITfRange::IsEqualStart verifica che l'ancoraggio iniziale di questo intervallo di testo corrisponda a un ancoraggio di un altro intervallo specificato.
ITfRange::SetGravity Metodo ITfRange::SetGravity
ITfRange::SetText Il metodo ITfRange::SetText sostituisce il contenuto coperto dall'intervallo di testo.
ITfRange::ShiftEnd Metodo ITfRange::ShiftEnd
ITfRange::ShiftEndRegion Metodo ITfRange::ShiftEndRegion
ITfRange::ShiftEndToRange Metodo ITfRange::ShiftEndToRange
ITfRange::ShiftStart Metodo ITfRange::ShiftStart
ITfRange::ShiftStartRegion Metodo ITfRange::ShiftStartRegion
ITfRange::ShiftStartToRange Metodo ITfRange::ShiftStartToRange

Commenti

Il manager TSF implementa questa interfaccia. Per altre informazioni su intervalli, ancoraggi, oggetti incorporati e altre proprietà di testo usate da TSF, vedere Intervalli, oggetti incorporati e altri argomenti all'interno di Using Text Services Framework.

Esempio

Dopo aver creato un'istanza di un oggetto di composizione ITfComposition , è possibile ottenere un puntatore a un puntatore dell'interfaccia ITfRange chiamando il metodo ITfComposition::GetRange , come illustrato nell'esempio di codice seguente.


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 puntatore a un oggetto ITfRange corrente può essere ottenuto dall'elemento <range> della struttura TF_SELECTION .

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional