Metodo ITfProperty::FindRange (msctf.h)
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 |
|---|---|
|
Il metodo è stato eseguito correttamente. |
|
pRange non è eccessivo o adiacente alla proprietà. ppRange riceve NULL. |
|
Uno o più parametri non sono validi. |
|
Si è verificato un errore di allocazione della memoria. |
|
Si è verificato un errore non specificato. |
|
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 |