Metodo ITextRange::SetIndex (tom.h)

Imposta questo intervallo sull'unità specificata del brano.

Sintassi

HRESULT SetIndex(
  [in] long Unit,
  [in] long Index,
  [in] long Extend
);

Parametri

[in] Unit

Tipo: long

Unità utilizzata per indicizzare l'intervallo. Per un elenco di valori unità, vedere ITextRange.

[in] Index

Tipo: long

Indice per l'unità. Questo intervallo viene spostato nell'unità con questo numero di indice. Se positivo, la numerazione di Units inizia all'inizio della storia e procede in avanti. Se negativo, la numerazione inizia alla fine della storia e procede all'indietro. L'inizio del brano corrisponde a un indice pari a 1 per tutte le unità esistenti e l'ultima unità del brano corrisponde a un indice pari a -1.

[in] Extend

Tipo: long

Flag che indica l'estensione dell'intervallo. Se zero (impostazione predefinita), l'intervallo viene compresso in un punto di inserimento nella posizione iniziale dell'unità specificata. Se diverso da zero, l'intervallo viene impostato sull'intera unità.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT . Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce uno dei codici di errore seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_INVALIDARG	Indice non valido.
E_NOTIMPL	L'unità non è supportata.
S_FALSE	Errore per un altro motivo.

Commenti

Questo metodo consente a un'applicazione di lavorare con testo orientato alla riga, ad esempio programmi, in modo pratico. Ad esempio, SetIndex(tomLine, 10, 0) converte un intervallo in un punto di inserimento all'inizio della decima riga.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h
DLL	Msftedit.dll

Vedi anche

Informazioni concettuali

ITextRange

Riferimento

Modello a oggetti di testo