Condividi tramite


Interfaccia ITfRange (msctf.h)

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

Vedi anche

Composizioni

Oggetti incorporati

ITfComposition

ITfComposition::GetRange

IUnknown

Intervalli

TF_SELECTION

Uso di Text Services Framework