Metodo ITextRange::D elete (tom.h)
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 |
|---|---|
|
Il testo è protetto da scrittura. |
|
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
Riferimento