Método ITextRange::Cut (tom.h)

Corta o texto simples ou avançado para um objeto de dados ou para a Área de Transferência, dependendo do parâmetro pVar .

Sintaxe

HRESULT Cut(
  VARIANT *pVar
);

Parâmetros

pVar

Tipo: VARIANT*

O texto cortado. pVar-ppunkVal> é o parâmetro out para um objeto IDataObject, desde que as seguintes condições existam:

  • pVar-vt> = (VT_UNKNOWN | VT_BYREF)
  • pVar não é nulo
  • pVar-ppunkVal> não é nulo
Caso contrário, a área de transferência será usada.

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.
E_OUTOFMEMORY
Sem memória.

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