Metodo ITextDocument::Save (tom.h)

Articolo
08/26/2023

Salva il documento.

Sintassi

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

Parametri

[in] pVar

Tipo: VARIANT*

Destinazione di salvataggio. Questo parametro è UN VALORE VARIANT, che può essere un nome file o NULL.

[in] Flags

Tipo: long

Creazione di file, apertura, condivisione e flag di conversione. Per un elenco dei valori possibili, vedere ITextDocument::Open.

[in] CodePage

Tipo: long

Tabella codici specificata. I valori comuni sono CP_ACP (zero: tabella codici ANSI di sistema), 1200 (Unicode) e 1208 (UTF-8).

Valore restituito

Tipo: HRESULT

Il valore restituito può essere un valore HRESULT che corrisponde a un codice di errore di sistema o a un codice di errore COM, incluso uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Il metodo ha esito positivo.
E_INVALIDARG	Argomento non valido.
E_OUTOFMEMORY	Memoria insufficiente.
E_NOTIMPL	Funzionalità non implementata.

Commenti

Per usare i parametri specificati per aprire il file, usare zero valori per i parametri.

Se pVar è null o mancante, viene usato il nome del file specificato dal nome del documento. Se entrambi sono mancanti o Null, il metodo ha esito negativo.

Se pVar specifica un nome file, tale nome deve sostituire la proprietà Nome corrente. Analogamente, gli argomenti Flag e CodePage possono sovraruolere quelli forniti nel metodo ITextDocument::Open e definire i valori da usare per i file creati con il metodo ITextDocument::New .

I file di testo normale Unicode devono essere salvati con il contrassegno di byte Unicode (0xFEFF) come primo carattere. Questo carattere deve essere rimosso quando il file viene letto; ovvero, viene usato solo per l'importazione/esportazione per identificare il testo normale come Unicode e per identificare l'ordine di byte di tale testo. Il Blocco note Microsoft ha adottato questa convenzione, che è ora consigliata dallo standard Unicode.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h
DLL	Msftedit.dll