Método ITextRange::D elete (tom.h)

Imita las teclas DELETE y BACKSPACE, con y sin la tecla CTRL presionada.

Sintaxis

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

Parámetros

Unit

Tipo: long

Unidad que se va a usar. La unidad puede ser tomCharacter (el valor predeterminado) o tomWord.

Count

Tipo: long

Número de unidadesque se van a eliminar. Si Count= cero, elimina solo el texto del intervalo. Si Count es mayor que cero, ITextRange::D elete actúa como si la tecla DELETE se presionara Tiempos de recuento . Si Count es menor que cero, actúa como si la tecla BACKSPACE se presionara Tiempos de recuento . El valor predeterminado es 1. Para obtener más información, vea la sección Notas.

pDelta

Tipo: long*

Recuento de unidades eliminadas. Puede ser NULL. El parámetro pDelta se establece igual al número de unidadeseliminadas. La eliminación del texto de un intervalo no degenerado cuenta como una unidad.

Valor devuelto

Tipo: HRESULT

Este método devuelve un valor HRESULT . Si se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve uno de los valores siguientes. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
E_ACCESSDENIED	El texto está protegido por escritura.
S_FALSE	Error por alguna otra razón.

Comentarios

Si Count = cero, este método elimina el texto del intervalo, es decir, no elimina nada si el intervalo es solo un punto de inserción.

Si Count no es cero y el intervalo es un punto de inserción (es decir, degenerado), | Recuento | (valor absoluto de Count) Las unidadesse eliminan en la dirección lógica dada por el signo de Recuento, donde un valor positivo es la dirección hacia el final del artículo, y un valor negativo está hacia el inicio del artículo.

Si Count no es cero y el intervalo no es degenerado (contiene texto), el texto del intervalo se elimina (independientemente de los valores de Unit y Count), lo que crea un punto de inserción. A continuación, | Recuento | - 1 Las unidadesse eliminan en la dirección lógica dada por el signo de Recuento.

El texto del intervalo también se puede eliminar mediante la asignación de una cadena nula al intervalo (la instrucción de ejecución r = donde es el intervalo). Sin embargo, ITextRange::D elete no requiere asignar un BSTR.

La eliminación de la marca de fin de párrafo (CR) da como resultado el comportamiento especial de la interfaz de usuario de Microsoft Word. Cuatro casos son de especial interés:

• Si elimina solo la CR, pero el párrafo incluye texto, se elimina la CR y el párrafo siguiente obtiene el mismo formato de párrafo que el actual.
• Si elimina la CR, pero no todas, de los caracteres del párrafo siguiente, los caracteres que quedan del párrafo actual obtienen el formato de párrafo siguiente.
• Si selecciona al final de un párrafo, pero no todo el párrafo, no se eliminará la CR.
• Si elimina todo el párrafo (desde el principio hasta la CR), también eliminará la CR (a menos que sea la CR final en el archivo).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tom.h
Archivo DLL	Msftedit.dll

Consulte también

Conceptual

ITextRange

Referencia

Modelo de objetos de texto