Metodo ITfReadOnlyProperty::EnumRanges (msctf.h)

Articolo
08/24/2023

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
S_OK	Il metodo è stato eseguito correttamente.
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. Nota Se un'applicazione non implementa ITextStoreACP::FindNextAttrTransition, ITfReadOnlyProperty::EnumRanges ha esito negativo con E_FAIL.
TF_E_NOLOCK	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