Méthode IXpsOMObjectFactory1 ::CreatePackageFromFile1 (xpsobjectmodel_1.h)

Ouvre un fichier de package XPS et retourne une arborescence d’objets de document XPS instanciée. Cette méthode lit un fichier qui contient un document XPS de type XPS_DOCUMENT_TYPE_ XPS ou XPS_DOCUMENT_TYPE_ OPENXPS

Syntaxe

HRESULT CreatePackageFromFile1(
  LPCWSTR        filename,
  BOOL           reuseObjects,
  IXpsOMPackage1 **package
);

Paramètres

filename

[in, string] Nom du fichier de package XPS.

reuseObjects

[in] Valeur booléenne qui indique que le logiciel tente d’optimiser l’arborescence d’objets de document en partageant des objets identiques dans toutes les propriétés et tous les enfants.

VRAI : le logiciel tente d’optimiser l’arborescence d’objets.

FALSE : le logiciel ne tente pas d’optimiser l’arborescence d’objets.

package

[out, retval] Pointeur vers la nouvelle interface IXpsOMPackage1 qui contient l’arborescence d’objets de document XPS qui a été lue à partir du nom de fichier.

Valeur retournée

Elle retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, les éléments suivants. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées ici, consultez Erreurs de document XPS.

S_OK : la méthode a réussi.

XPS_E_UNEXPECTED_NAMESPACE : le balisage de package utilise un espace de noms qui n’est pas pris en charge par le type de document

XPS_E_ABSOLUTE_REFERENCE : le document OpenXPS contient des éléments XML qui utilisent des URI absolus pour référencer d’autres parties du document.

Remarques

Utilisez cette méthode pour lire un fichier qui contient un document XPS qui peut être de type XPS_DOCUMENT_TYPE_ XPS ou XPS_DOCUMENT_TYPE_ OPENXPS. CreatePackageFromFile, publié dans Windows 7, ouvre uniquement les fichiers qui contiennent un document XPS de type XPS_DOCUMENT_TYPE_ XPS.

Configuration requise

Voir aussi

IXpsOMObjectFactory1