Share via

ITextDocument::Save メソッド (tom.h)

  • [アーティクル]

ドキュメントを保存します。

構文

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 (Unicode)、1208 (UTF-8) です。

戻り値

型: HRESULT

戻り値には、システム エラー コードまたは COM エラー コードに対応する HRESULT 値を指定できます。これには、次のいずれかの値が含まれます。

リターン コード 説明
S_OK
 メソッドは成功します。
E_INVALIDARG
 引数が無効です。
E_OUTOFMEMORY
 メモリ不足です。
E_NOTIMPL
 機能が実装されていません。

解説

ファイルを開くために指定されたパラメーターを使用するには、パラメーターにゼロ値を使用します。

pVar が null または不足している場合は、このドキュメントの名前によって指定されたファイル名が使用されます。 これら両方が見つからないか null の場合、メソッドは失敗します。

pVar でファイル名が指定されている場合、その名前は現在の Name プロパティを置き換える必要があります。 同様に、 Flags 引数と CodePage 引数は 、ITextDocument::Open メソッドで指定されたものよりも優先され、 ITextDocument::New メソッドで作成されたファイルに使用する値を定義できます。

Unicode プレーンテキスト ファイルは、最初の文字として Unicode バイト順マーク (0xFEFF) で保存する必要があります。 この文字は、ファイルが読み込まれるときに削除する必要があります。つまり、プレーン テキストを Unicode として識別し、そのテキストのバイト順を識別するために、インポート/エクスポートにのみ使用されます。 Microsoft Notepad では、Unicode 標準で推奨されるこの規則が採用されました。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー tom.h
[DLL] Msftedit.dll

関連項目

概念

ITextDocument

[新規作成]

[ファイル]

リファレンス

Text オブジェクト モデル