Metodo ITextRange::D elete (tom.h)

  • Articolo

Simula i tasti DELETE e BACKSPACE, con e senza il tasto CTRL premuto.

Sintassi

HRESULT Delete(
  long Unit,
  long Count,
  long *pDelta
);

Parametri

Unit

Tipo: long

Unità da usare. L'unità può essere tomCharacter (il valore predefinito) o tomWord.

Count

Tipo: long

Numero di unitàda eliminare. Se Count= zero, elimina il testo solo nell'intervallo. Se Count è maggiore di zero, ITextRange::D elete agisce come se il tasto DELETE fosse premuto Conteggio . Se Count è minore di zero, funziona come se il tasto BACKSPACE fosse premuto Numero volte. Il valore predefinito è 1. Per ulteriori informazioni, vedere la sezione Osservazioni.

pDelta

Tipo: long*

Numero di unità eliminate. Può essere Null. Il parametro pDelta è impostato uguale al numero di unitàeliminate. L'eliminazione del testo in un intervallo non generato viene conteggiata come un'unità.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce un valore HRESULT . Se ha esito positivo, restituisce S_OK. In caso contrario, restituisce uno dei valori seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito Descrizione
E_ACCESSDENIED
 Il testo è protetto da scrittura.
S_FALSE
 Errore per qualche altro motivo.

Commenti

Se Count = zero, questo metodo elimina il testo nell'intervallo, ovvero elimina nulla se l'intervallo è solo un punto di inserimento.

Se Count non è zero e l'intervallo è un punto di inserimento (ovvero, degenerato), | Conteggio | (valore assoluto di Count) Le unitàvengono eliminate nella direzione logica specificata dal segno di Count, dove un valore positivo è la direzione verso la fine della storia e un valore negativo è verso l'inizio della storia.

Se Count non è zero e l'intervallo non è generato (contiene testo), il testo nell'intervallo viene eliminato (indipendentemente dai valori di Unit e Count), creando così un punto di inserimento. Quindi, | Conteggio | - 1 L'unitàviene eliminata nella direzione logica specificata dal segno di Count.

Il testo nell'intervallo può essere eliminato anche assegnando una stringa Null all'intervallo (esecuzione dell'istruzione r = dove è l'intervallo). Tuttavia, ITextRange::D elete non richiede l'allocazione di un BSTR.

L'eliminazione del segno di fine paragrafo (CR) comporta un comportamento speciale dell'interfaccia utente di Microsoft Word. Quattro casi sono di particolare interesse:

  • Se si elimina solo cr, ma il paragrafo include testo, il CR viene eliminato e il paragrafo seguente ottiene la stessa formattazione del paragrafo di quella corrente.
  • Se si elimina il cr e alcuni, ma non tutti, dei caratteri nel paragrafo seguente, i caratteri lasciati dal paragrafo corrente ottengono la formattazione del paragrafo seguente.
  • Se si seleziona alla fine di un paragrafo, ma non all'intero paragrafo, il CR non viene eliminato.
  • Se si elimina l'intero paragrafo (dall'inizio al CR), si elimina anche CR (a meno che non sia il CR finale nel file).

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 testo