Metodo ITfReadOnlyProperty::EnumRanges (msctf.h)
Ottiene un'enumerazione di intervalli che contengono valori univoci della proprietà all'interno dell'intervallo specificato.
Sintassi
HRESULT EnumRanges(
[in] TfEditCookie ec,
[out] IEnumTfRanges **ppEnum,
[in] ITfRange *pTargetRange
);
Parametri
[in] ec
Contiene un cookie di modifica che identifica il contesto di modifica. Si ottiene da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.
[out] ppEnum
Puntatore a un puntatore all'interfaccia IEnumTfRanges che riceve l'oggetto enumeratore. Il chiamante deve rilasciare questo oggetto quando non è più necessario.
[in] pTargetRange
Puntatore a un'interfaccia ITfRange che specifica l'intervallo da analizzare per individuare valori di proprietà univoci. Questo parametro è facoltativo e può essere NULL. Per altre informazioni, vedere la sezione Osservazioni.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Valore | Descrizione |
|---|---|
|
Il metodo è stato eseguito correttamente. |
|
Uno o più parametri non sono validi. |
|
Si è verificato un errore di allocazione della memoria. |
|
Si è verificato un errore non specificato.
Nota Se un'applicazione non implementa ITextStoreACP::FindNextAttrTransition, ITfReadOnlyProperty::EnumRanges ha esito negativo con E_FAIL.
|
|
Il contesto di modifica identificato da ec non ha un blocco di sola lettura o di lettura/scrittura. |
Commenti
Nota: Se un'applicazione non implementa ITextStoreACP::FindNextAttrTransition, ITfReadOnlyProperty::EnumRanges ha esito negativo con E_FAIL.
L'enumeratore ottenuto da questo metodo conterrà un intervallo per ogni valore univoco, inclusi i valori vuoti, della proprietà specificata. Ad esempio, una proprietà di colore ipotetica può essere applicata al testo contrassegnato come segue:
COLOR: RR GGGGGGGG
TEXT: this is some colored text
Quando ITfReadOnlyProperty::EnumRanges viene chiamato con pTargetRange impostato su questo intervallo, l'enumeratore conterrà cinque intervalli.
| Indice di intervallo | Valore proprietà Color | Testo intervallo |
|---|---|---|
| 0 | <empty> | "questo" |
| 1 | R | "is" |
| 2 | <empty> | " some " |
| 3 | G | "colorato" |
| 4 | <empty> | "text" |
Se pTargetRange è NULL, l'enumeratore inizierà e terminerà con il primo e l'ultimo intervallo che contiene un valore di proprietà non vuoto nel contesto. Se si specifica NULL per pTargetRange nell'esempio precedente, verrà generato un enumeratore con tre intervalli.
| Indice di intervallo | Valore proprietà Color | Testo compreso nell'intervallo |
|---|---|---|
| 0 | R | "is" |
| 1 | <empty> | " some " |
| 2 | G | "colorato" |
Gli intervalli enumerati inizieranno e terminano con gli ancoraggi iniziale e finale di pTargetRange, anche se uno degli ancoraggi è posizionato al centro di una proprietà.
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 |