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

Imita as teclas DELETE e BACKSPACE, com e sem a tecla CTRL pressionada.

Sintaxe

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

Parâmetros

Unit

Tipo: long

Unidade a ser usada. A unidade pode ser tomCharacter (o valor padrão) ou tomWord.

Count

Tipo: long

Número de Unidadesa serem excluídas. Se Count= zero, ele exclui o texto somente no intervalo. Se Count for maior que zero, ITextRange::D elete atuará como se a tecla DELETE tivesse sido pressionada Contagem de vezes. Se Count for menor que zero, ele atuará como se a tecla BACKSPACE tivesse sido pressionada Contagem de vezes. O valor padrão é 1. Para obter mais informações, consulte Comentários.

pDelta

Tipo: long*

A contagem de unidades excluídas. Pode ser nula. O parâmetro pDelta é definido como igual ao número de Unidadesexcluídas. Excluir o texto em um intervalo não descritivo conta como uma Unidade.

Retornar valor

Tipo: HRESULT

Esse método retorna um valor HRESULT . Se tiver êxito, ele retornará S_OK. Caso contrário, retornará um dos valores a seguir. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_ACCESSDENIED	O texto é protegido por gravação.
S_FALSE	Falha por algum outro motivo.

Comentários

Se Count = zero, esse método excluirá o texto no intervalo, ou seja, ele não excluirá nada se o intervalo for apenas um ponto de inserção.

Se Count não for zero e o intervalo for um ponto de inserção (ou seja, degenerado), | Contagem| (valor absoluto de Count) As unidadessão excluídas na direção lógica fornecida pelo sinal de Count, em que um valor positivo é a direção para o final da história, e um valor negativo é para o início da história.

Se Count não for zero e o intervalo não for indegenerado (contiver texto), o texto no intervalo será excluído (independentemente dos valores de Unidade e Contagem), criando assim um ponto de inserção. Em seguida, | Contagem| - 1 As unidadessão excluídas na direção lógica fornecida pelo sinal de Contagem.

O texto no intervalo também pode ser excluído atribuindo uma cadeia de caracteres nula ao intervalo (executando a instrução r = em que é o intervalo). No entanto, ITextRange::D elete não requer a alocação de um BSTR.

A exclusão da CR (marca de fim de parágrafo) resulta no comportamento especial da interface do usuário do Microsoft Word. Quatro casos são de interesse específico:

• Se você excluir apenas o CR, mas o parágrafo incluir texto, o CR será excluído e o parágrafo a seguir obterá a mesma formatação de parágrafo que a atual.
• Se você excluir o CR, bem como alguns, mas não todos, dos caracteres no parágrafo a seguir, os caracteres restantes do parágrafo atual obterão a formatação de parágrafo do parágrafo a seguir.
• Se você selecionar até o final de um parágrafo, mas não o parágrafo inteiro, o CR não será excluído.
• Se você excluir o parágrafo inteiro (do início até o CR), exclua o CR também (a menos que seja o CR final no arquivo).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h
DLL	Msftedit.dll

Confira também

Conceitual

ITextRange

Referência

Modelo de objeto de texto