Método ITextDocument::Save (tom.h)

Artigo
08/26/2023

Salva o documento.

Sintaxe

HRESULT Save(
  [in] VARIANT *pVar,
  [in] long    Flags,
  [in] long    CodePage
);

Parâmetros

[in] pVar

Tipo: VARIANT*

O destino de salvamento. Esse parâmetro é um VARIANT, que pode ser um nome de arquivo ou NULL.

[in] Flags

Tipo: long

Criação, abertura, compartilhamento e sinalizadores de conversão de arquivo. Para obter uma lista de valores possíveis, consulte ITextDocument::Open.

[in] CodePage

Tipo: long

A página de código especificada. Os valores comuns são CP_ACP (zero: página de código ANSI do sistema), 1200 (Unicode) e 1208 (UTF-8).

Valor retornado

Tipo: HRESULT

O valor retornado pode ser um valor HRESULT que corresponde a um código de erro do sistema ou um código de erro COM, incluindo um dos valores a seguir.

Código de retorno	Descrição
S_OK	O método é bem-sucedido.
E_INVALIDARG	Argumento inválido.
E_OUTOFMEMORY	Memória insuficiente.
E_NOTIMPL	Recurso não implementado.

Comentários

Para usar os parâmetros especificados para abrir o arquivo, use valores zero para os parâmetros.

Se pVar for nulo ou estiver ausente, o nome do arquivo fornecido pelo nome deste documento será usado. Se ambos estiverem ausentes ou nulos, o método falhará.

Se pVar especificar um nome de arquivo, esse nome deverá substituir a propriedade Name atual. Da mesma forma, os argumentos Flags e CodePage podem anular aqueles fornecidos no método ITextDocument::Open e definir os valores a serem usados para arquivos criados com o método ITextDocument::New .

Os arquivos de texto sem formatação Unicode devem ser salvos com a marca de ordem de bytes Unicode (0xFEFF) como o primeiro caractere. Esse caractere deve ser removido quando o arquivo é lido; ou seja, ele só é usado para importação/exportação para identificar o texto sem formatação como Unicode e para identificar a ordem de bytes desse texto. O Microsoft Notepad adotou essa convenção, que agora é recomendada pelo padrão Unicode.

Requisitos


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