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

Article
08/26/2023

Enregistre le document.

Syntaxe

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

Paramètres

[in] pVar

Type : VARIANT*

Cible d’enregistrement. Ce paramètre est un VARIANT, qui peut être un nom de fichier ou NULL.

[in] Flags

Type : long

Indicateurs de création, d’ouverture, de partage et de conversion de fichiers. Pour obtenir la liste des valeurs possibles, consultez ITextDocument::Open.

[in] CodePage

Type : long

Page de codes spécifiée. Les valeurs courantes sont CP_ACP (zéro : page de codes ANSI système), 1200 (Unicode) et 1208 (UTF-8).

Valeur retournée

Type : HRESULT

La valeur de retour peut être une valeur HRESULT qui correspond à un code d’erreur système ou à un code d’erreur COM, y compris l’une des valeurs suivantes.

Code de retour	Description
S_OK	La méthode réussit.
E_INVALIDARG	Argument non valide.
E_OUTOFMEMORY	Mémoire insuffisante.
E_NOTIMPL	Fonctionnalité non implémentée.

Remarques

Pour utiliser les paramètres spécifiés pour l’ouverture du fichier, utilisez des valeurs nulles pour les paramètres.

Si pVar est null ou manquant, le nom de fichier donné par le nom de ce document est utilisé. Si ces deux éléments sont manquants ou null, la méthode échoue.

Si pVar spécifie un nom de fichier, ce nom doit remplacer la propriété Name actuelle. De même, les arguments Flags et CodePage peuvent remplacer ceux fournis dans la méthode ITextDocument::Open et définir les valeurs à utiliser pour les fichiers créés avec la méthode ITextDocument::New .

Les fichiers de texte brut Unicode doivent être enregistrés avec la marque d’ordre d’octet Unicode (0xFEFF) comme premier caractère. Ce caractère doit être supprimé lors de la lecture du fichier ; autrement dit, il est utilisé uniquement pour l’importation/exportation afin d’identifier le texte brut en tant qu’Unicode et d’identifier l’ordre d’octets de ce texte. Le Bloc-notes Microsoft a adopté cette convention, qui est désormais recommandée par la norme Unicode.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tom.h
DLL	Msftedit.dll