Método ITextStrings::Append (tom.h)

  • Artigo

Acrescenta uma cadeia de caracteres à cadeia de caracteres no índice especificado na coleção.

Sintaxe

HRESULT Append(
  [in] ITextRange2 *pRange,
  [in] long        iString
);

Parâmetros

[in] pRange

Tipo: ITextRange2*

A cadeia de caracteres a ser acrescentada.

[in] iString

Tipo: long

O índice de cadeia de caracteres.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro COM. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno Descrição
E_INVALIDARG
 Argumento inválido.
E_OUTOFMEMORY
 Memória insuficiente.

Comentários

O índice é relativo à parte superior da coleção, portanto, se iString for igual a 0, a cadeia de caracteres será inserida na parte superior. Se iString for igual a –1, ela será inserida abaixo da cadeia de caracteres superior e assim por diante.

Requisitos

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

Confira também

ITextStrings