Metodo ITfProperty::FindRange (msctf.h)

  • Articolo

Ottiene un intervallo che copre il testo contenente un valore non vuoto per la proprietà.

Sintassi

HRESULT FindRange(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pRange,
  [out] ITfRange     **ppRange,
  [in]  TfAnchor     aPos
);

Parametri

[in] ec

Contiene un cookie di modifica che identifica il contesto di modifica. Questa operazione viene ottenuta da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] pRange

Puntatore a un'interfaccia ITfRange che contiene il punto per ottenere l'intervallo di proprietà per. Il punto sarà l'ancoraggio iniziale o l'ancoraggio finale di questo intervallo, in base al valore di aPos.

[out] ppRange

Puntatore a un puntatore dell'interfaccia ITfRange che riceve l'oggetto intervallo richiesto.

[in] aPos

Contiene uno dei valori TfAnchor che specifica quale ancoraggio di pRange viene usato come punto per ottenere l'intervallo di proprietà per.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
 Il metodo è stato eseguito correttamente.
S_FALSE
 pRange non è eccessivo o adiacente alla proprietà. ppRange riceve NULL.
E_INVALIDARG
 Uno o più parametri non sono validi.
E_OUTOFMEMORY
 Si è verificato un errore di allocazione della memoria.
E_FAIL
 Si è verificato un errore non specificato.
TF_E_NOLOCK
 Il contesto di modifica identificato da ec non ha un blocco di sola lettura o lettura/scrittura.

Commenti

Questo metodo ottiene un intervallo di testo contenente un valore non vuoto per la proprietà. Se la proprietà non ha alcun valore nel punto specificato, ppRange riceve NULL e il metodo restituisce S_FALSE. Nell'esempio seguente, se aPos contiene TF_ANCHOR_START, l'intervallo restituito conterrà "is". Se aPos contiene TF_ANCHOR_END, il metodo restituirà S_FALSE perché la proprietà non esiste al punto finale dell'intervallo.


COLOR: RRRRR   RR          GGGGGGGG
TEXT:  this <a>is som</a>e colored text

Se aPos contiene TF_ANCHOR_START, questo metodo ignora gli intervalli di proprietà che terminano immediatamente prima dell'ancoraggio iniziale. Analogamente, se aPos contiene TF_ANCHOR_END, questo metodo ignora gli intervalli di proprietà che iniziano immediatamente dopo l'ancoraggio finale. Nell'esempio seguente, se aPos contiene TF_ANCHOR_START, l'intervallo restituito contiene "colorato" e non "alcuni" perché la proprietà R value termina al punto di ancoraggio iniziale e la proprietà valore G inizia all'ancoraggio iniziale. Se aPos contiene TF_ANCHOR_END, l'intervallo restituito contiene "colorato" e non "text".


COLOR:         RRRRR   GGGGGGGG    BBBB
TEXT:  this is some <a>colored </a>text

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
DLL Msctf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange

TfAnchor