Метод ITextDocument::Save (tom.h)

Статья
08/26/2023

Сохраняет документ.

Синтаксис

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

Параметры

[in] pVar

Тип: VARIANT*

Целевой объект сохранения. Это параметр VARIANT, который может быть именем файла или значением NULL.

[in] Flags

Тип: long

Флаги создания, открытия, совместного использования и преобразования файлов. Список возможных значений см. в разделе ITextDocument::Open.

[in] CodePage

Тип: long

Указанная кодовая страница. Общие значения: CP_ACP (ноль: системная кодовая страница ANSI), 1200 (Юникод) и 1208 (UTF-8).

Возвращаемое значение

Тип: HRESULT

Возвращаемое значение может быть значением HRESULT , которое соответствует коду системной ошибки или коду ошибки COM, включая одно из следующих значений.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Недопустимый аргумент.
E_OUTOFMEMORY	Недостаточно памяти.
E_NOTIMPL	Функция не реализована.

Если pVar имеет значение NULL или отсутствует, используется имя файла, заданное именем этого документа. Если оба они отсутствуют или имеют значение NULL, метод завершается ошибкой.

Если pVar указывает имя файла, это имя должно заменить текущее свойство Name. Аналогичным образом аргументы Flags и CodePage могут отменить те, которые были предоставлены в методе ITextDocument::Open , и определить значения, которые будут использоваться для файлов, созданных с помощью метода ITextDocument::New .

Файлы Юникода в виде обычного текста должны сохраняться с меткой порядка байтов Юникода (0xFEFF) в качестве первого символа. Этот символ должен быть удален при чтении файла; то есть он используется только для импорта и экспорта, чтобы определить обычный текст как Юникод и определить порядок байтов этого текста. Microsoft Notepad принял это соглашение, которое теперь рекомендуется стандартом Юникода.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	tom.h
DLL	Msftedit.dll