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 |