PdfSaveOptions

PdfSaveOptions class

Peut être utilisé pour spécifier des options supplémentaires lors de l’enregistrement d’un document dans lePdf format.

Pour en savoir plus, visitez leSpécifier les options d’enregistrement article documentaire.

public class PdfSaveOptions : FixedPageSaveOptions

Constructeurs

NomLa description
PdfSaveOptions()Initialise une nouvelle instance de cette classe qui peut être utilisée pour enregistrer un document dans le Pdf format.

Propriétés

NomLa description
AdditionalTextPositioning { get; set; }Un indicateur spécifiant s’il faut écrire ou non des opérateurs de positionnement de texte supplémentaires.
AllowEmbeddingPostScriptFonts { get; set; }Obtient ou définit une valeur booléenne indiquant s’il faut autoriser l’incorporation de polices avec des contours PostScript lors de l’incorporation de polices TrueType dans un document lors de son enregistrement. La valeur par défaut estFAUX .
CacheBackgroundGraphics { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non mettre en cache les graphiques placés en arrière-plan du document.
ColorMode { get; set; }Obtient ou définit une valeur déterminant la manière dont les couleurs sont rendues.
Compliance { get; set; }Spécifie le niveau de conformité aux normes PDF pour les documents de sortie.
CreateNoteHyperlinks { get; set; }Spécifie s’il faut convertir les références de note de bas de page/note de fin dans l’histoire du texte principal en hyperliens actifs. Lorsque vous cliquez dessus, le lien hypertexte mènera à la note de bas de page/note de fin correspondante. La valeur par défaut estFAUX .
CustomPropertiesExport { get; set; }Obtient ou définit une valeur déterminant la manièreCustomDocumentProperties sont exportés vers un fichier PDF.
CustomTimeZoneInfo { get; set; }Obtient ou définit le fuseau horaire local personnalisé utilisé pour les champs de date/heure.
DefaultTemplate { get; set; }Obtient ou définit le chemin d’accès au modèle par défaut (y compris le nom de fichier). La valeur par défaut de cette propriété estchaîne vide (Empty).
DigitalSignatureDetails { get; set; }Obtient ou définit les détails de signature du document PDF de sortie.
DisplayDocTitle { get; set; }Un indicateur spécifiant si la barre de titre de la fenêtre doit afficher le titre du document tiré de l’entrée Titre du dictionnaire d’informations sur le document.
Dml3DEffectsRenderingMode { get; set; }Obtient ou définit une valeur déterminant la manière dont les effets 3D sont rendus.
override DmlEffectsRenderingMode { get; set; }Obtient ou définit une valeur déterminant la façon dont les effets DrawingML sont rendus.
DmlRenderingMode { get; set; }Obtient ou définit une valeur déterminant la façon dont les formes DrawingML sont rendues.
DownsampleOptions { get; set; }Permet de spécifier les options de sous-échantillonnage.
EmbedAttachments { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non intégrer les pièces jointes au document PDF.
EmbedFullFonts { get; set; }Contrôle la manière dont les polices sont intégrées dans les documents PDF résultants.
EncryptionDetails { get; set; }Obtient ou définit les détails de cryptage du document PDF de sortie.
ExportDocumentStructure { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non exporter la structure du document.
ExportGeneratorName { get; set; }Quandvrai , entraîne l’intégration du nom et de la version d’Aspose.Words dans les fichiers produits. La valeur par défaut estvrai .
ExportLanguageToSpanTag { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non créer une balise “Span” dans la structure du document pour exporter la langue du texte.
ExportParagraphGraphicsToArtifact { get; set; }Obtient ou définit une valeur déterminant si un graphique de paragraphe doit être marqué comme artefact.
FontEmbeddingMode { get; set; }Spécifie le mode d’incorporation de police.
HeaderFooterBookmarksExportMode { get; set; }Détermine la manière dont les signets dans les en-têtes/pieds de page sont exportés.
ImageColorSpaceExportMode { get; set; }Spécifie comment l’espace colorimétrique sera sélectionné pour les images dans le document PDF.
ImageCompression { get; set; }Spécifie le type de compression à utiliser pour toutes les images du document.
ImlRenderingMode { get; set; }Obtient ou définit une valeur déterminant la manière dont les objets Ink (InkML) sont rendus.
InterpolateImages { get; set; }Un indicateur indiquant si l’interpolation d’image doit être effectuée par un lecteur conforme. LorsqueFAUX est spécifié, l’indicateur n’est pas écrit dans le document de sortie et le comportement par défaut du lecteur est utilisé à la place.
JpegQuality { get; set; }Obtient ou définit une valeur déterminant la qualité des images JPEG dans le document PDF.
MemoryOptimization { get; set; }Obtient ou définit la valeur déterminant si l’optimisation de la mémoire doit être effectuée avant d’enregistrer le document. La valeur par défaut de cette propriété estFAUX .
MetafileRenderingOptions { get; set; }Permet de spécifier les options de rendu du métafichier.
NumeralFormat { get; set; }Obtient ou définitNumeralFormat utilisé pour le rendu des chiffres. Les chiffres européens sont utilisés par défaut.
OpenHyperlinksInNewWindow { get; set; }Obtient ou définit une valeur déterminant si les hyperliens dans le document Pdf de sortie doivent être ouverts de force dans une nouvelle fenêtre (ou onglet) d’un navigateur.
virtual OptimizeOutput { get; set; }L’indicateur indique s’il est nécessaire d’optimiser la sortie. Si cet indicateur est défini, les canevas imbriqués redondants et les canevas vides sont supprimés, également les glyphes voisins avec le même formatage sont concaténés. Remarque : la précision de l’affichage du contenu peut être affectée si cette propriété est définie survrai . La valeur par défaut estFAUX .
OutlineOptions { get; }Permet de spécifier les options de contour.
PageMode { get; set; }Spécifie comment le document PDF doit être affiché lorsqu’il est ouvert dans le lecteur PDF.
PageSavingCallback { get; set; }Permet de contrôler la façon dont les pages séparées sont enregistrées lorsqu’un document est exporté au format de page fixe.
PageSet { get; set; }Obtient ou définit les pages à restituer. La valeur par défaut est toutes les pages du document.
PreblendImages { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non prémélanger les images transparentes avec une couleur d’arrière-plan noire.
PreserveFormFields { get; set; }Spécifie s’il faut conserver les champs de formulaire Microsoft Word en tant que champs de formulaire dans le PDF ou les convertir en texte. La valeur par défaut estFAUX .
PrettyFormat { get; set; }Quandvrai jolis formats de sortie le cas échéant. La valeur par défaut estFAUX .
ProgressCallback { get; set; }Appelé lors de l’enregistrement d’un document et accepte les données sur la progression de l’enregistrement.
override SaveFormat { get; set; }Spécifie le format dans lequel le document sera enregistré si cet objet d’options de sauvegarde est utilisé. Ne peut êtrePdf .
TempFolder { get; set; }Spécifie le dossier des fichiers temporaires utilisé lors de l’enregistrement dans un fichier DOC ou DOCX. Par défaut, cette propriété estnul et aucun fichier temporaire n’est utilisé.
TextCompression { get; set; }Spécifie le type de compression à utiliser pour tout le contenu textuel du document.
UpdateCreatedTimeProperty { get; set; }Obtient ou définit une valeur déterminant si leCreatedTime la propriété est mise à jour avant l’enregistrement. La valeur par défaut estFAUX ;
UpdateFields { get; set; }Obtient ou définit une valeur déterminant si les champs de certains types doivent être mis à jour avant d’enregistrer le document dans un format de page fixe. La valeur par défaut de cette propriété estvrai .
UpdateLastPrintedProperty { get; set; }Obtient ou définit une valeur déterminant si leLastPrinted la propriété est mise à jour avant l’enregistrement.
UpdateLastSavedTimeProperty { get; set; }Obtient ou définit une valeur déterminant si leLastSavedTime la propriété est mise à jour avant l’enregistrement.
UseAntiAliasing { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non utiliser l’anticrénelage pour le rendu.
UseBookFoldPrintingSettings { get; set; }Obtient ou définit une valeur booléenne indiquant si le document doit être enregistré à l’aide d’une mise en page d’impression en livret, s’il est spécifié viaMultiplePages .
UseCoreFonts { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non remplacer les polices TrueType Arial, Times New Roman, Courier New et Symbol par les polices PDF Type 1 de base.
UseHighQualityRendering { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non utiliser des algorithmes de rendu de haute qualité (c’est-à-dire lents).
ZoomBehavior { get; set; }Obtient ou définit une valeur déterminant le type de zoom à appliquer lorsqu’un document est ouvert avec une visionneuse PDF.
ZoomFactor { get; set; }Obtient ou définit une valeur déterminant le facteur de zoom (en pourcentages) pour un document.

Méthodes

NomLa description
Clone()Crée un clone profond de cet objet.
override Equals(object)Détermine si l’objet spécifié a une valeur égale à l’objet actuel.

Exemples

Montre comment changer la couleur de l’image avec la propriété des options d’enregistrement.

Document doc = new Document(MyDir + "Images.docx");

// Crée un objet "PdfSaveOptions" que l'on peut passer à la méthode "Save" du document
// pour modifier la façon dont cette méthode convertit le document en .PDF.
// Définissez la propriété "ColorMode" sur "Grayscale" pour restituer toutes les images du document en noir et blanc.
// La taille du document de sortie peut être plus grande avec ce paramètre.
// Définissez la propriété "ColorMode" sur "Normal" pour restituer toutes les images en couleur.
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions { ColorMode = colorMode };

doc.Save(ArtifactsDir + "PdfSaveOptions.ColorRendering.pdf", pdfSaveOptions);

Montre comment appliquer une compression de texte lors de l’enregistrement d’un document au format PDF.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

for (int i = 0; i < 100; i++)
    builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
                    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

// Crée un objet "PdfSaveOptions" que l'on peut passer à la méthode "Save" du document
// pour modifier la façon dont cette méthode convertit le document en .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// Définit la propriété "TextCompression" sur "PdfTextCompression.None" pour n'appliquer aucune
// compression en texte lorsque nous enregistrons le document au format PDF.
// Définissez la propriété "TextCompression" sur "PdfTextCompression.Flate" pour appliquer la compression ZIP
// en texte lorsque nous enregistrons le document au format PDF. Plus le document est volumineux, plus l’impact qu’il aura sera important.
options.TextCompression = pdfTextCompression;

doc.Save(ArtifactsDir + "PdfSaveOptions.TextCompression.pdf", options);

Montre comment convertir un document entier en PDF avec trois niveaux dans le plan du document.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insère les titres des niveaux 1 à 5.
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;

Assert.True(builder.ParagraphFormat.IsHeading);

builder.Writeln("Heading 1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;

builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;

builder.Writeln("Heading 1.2.1");
builder.Writeln("Heading 1.2.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading4;

builder.Writeln("Heading 1.2.2.1");
builder.Writeln("Heading 1.2.2.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading5;

builder.Writeln("Heading 1.2.2.2.1");
builder.Writeln("Heading 1.2.2.2.2");

// Crée un objet "PdfSaveOptions" que l'on peut passer à la méthode "Save" du document
// pour modifier la façon dont cette méthode convertit le document en .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// Le document PDF de sortie contiendra un plan, qui est une table des matières répertoriant les titres dans le corps du document.
// Cliquer sur une entrée de ce plan nous amènera à l'emplacement de son en-tête respectif.
// Définissez la propriété "HeadingsOutlineLevels" sur "4" pour exclure du plan tous les titres dont les niveaux sont supérieurs à 4.
options.OutlineOptions.HeadingsOutlineLevels = 4;

// Si une entrée de plan a des entrées ultérieures d'un niveau supérieur entre elle et l'entrée suivante du même niveau ou d'un niveau inférieur,
// une flèche apparaîtra à gauche de l'entrée. Cette entrée est le « propriétaire » de plusieurs de ces « sous-entrées ».
// Dans notre document, les entrées de plan du 5ème niveau de titre sont des sous-entrées de la deuxième entrée de plan de 4ème niveau,
// les entrées de 4ème et 5ème niveau de titre sont des sous-entrées de la deuxième entrée de 3ème niveau, et ainsi de suite.
// Dans le plan, on peut cliquer sur la flèche de l'entrée "propriétaire" pour réduire/développer toutes ses sous-entrées.
// Définissez la propriété "ExpandedOutlineLevels" sur "2" pour développer automatiquement toutes les entrées de titre de niveau 2 et inférieur.
// et réduit toutes les entrées de niveau 3 et supérieur lorsque nous ouvrons le document.
options.OutlineOptions.ExpandedOutlineLevels = 2;

doc.Save(ArtifactsDir + "PdfSaveOptions.ExpandedOutlineLevels.pdf", options);

Voir également

PdfPermissions Enum PdfTextCompression Enum