PdfSaveOptions
Contenido
[
Ocultar
]PdfSaveOptions class
Se puede utilizar para especificar opciones adicionales al guardar un documento en elPdf formato.
Para obtener más información, visite elEspecificar opciones de guardado Artículo de documentación.
public class PdfSaveOptions : FixedPageSaveOptions
Constructores
| Nombre | Descripción |
|---|---|
| PdfSaveOptions() | Inicializa una nueva instancia de esta clase que se puede usar para guardar un documento en el Pdf formato. |
Propiedades
| Nombre | Descripción |
|---|---|
| AdditionalTextPositioning { get; set; } | Un indicador que especifica si se deben escribir operadores de posicionamiento de texto adicionales o no. |
| AllowEmbeddingPostScriptFonts { get; set; } | Obtiene o establece un valor booleano que indica si se debe permitir la incrustación de fuentes con contornos PostScript al incrustar fuentes TrueType en un documento al guardarlo. El valor predeterminado esFALSO . |
| AttachmentsEmbeddingMode { get; set; } | Obtiene o establece un valor que determina cómo se incrustan los archivos adjuntos en el documento PDF. |
| CacheBackgroundGraphics { get; set; } | Obtiene o establece un valor que determina si se deben almacenar o no en caché los gráficos colocados en el fondo del documento. |
| ColorMode { get; set; } | Obtiene o establece un valor que determina cómo se representan los colores. |
| Compliance { get; set; } | Especifica el nivel de cumplimiento de los estándares PDF para los documentos de salida. |
| CreateNoteHyperlinks { get; set; } | Especifica si se deben convertir las referencias de notas al pie o notas al final del texto principal en hipervínculos activos. Al hacer clic, el hipervínculo llevará a la nota al pie o nota al final correspondiente. El valor predeterminado esFALSO . |
| CustomPropertiesExport { get; set; } | Obtiene o establece un valor que determina la formaCustomDocumentProperties se exportan a archivo PDF. |
| CustomTimeZoneInfo { get; set; } | Obtiene o establece la zona horaria local personalizada utilizada para los campos de fecha y hora. |
| DefaultTemplate { get; set; } | Obtiene o establece la ruta a la plantilla predeterminada (incluido el nombre del archivo). El valor predeterminado para esta propiedad escadena vacía (Empty ). |
| DigitalSignatureDetails { get; set; } | Obtiene o establece los detalles para firmar el documento PDF de salida. |
| DisplayDocTitle { get; set; } | Un indicador que especifica si la barra de título de la ventana debe mostrar el título del documento tomado de la entrada Título del diccionario de información del documento. |
| Dml3DEffectsRenderingMode { get; set; } | Obtiene o establece un valor que determina cómo se representan los efectos 3D. |
| override DmlEffectsRenderingMode { get; set; } | Obtiene o establece un valor que determina cómo se representan los efectos de DrawingML. |
| DmlRenderingMode { get; set; } | Obtiene o establece un valor que determina cómo se representan las formas de DrawingML. |
| DownsampleOptions { get; set; } | Permite especificar opciones de reducción de resolución. |
| EmbedFullFonts { get; set; } | Controla cómo se incrustan las fuentes en los documentos PDF resultantes. |
| EncryptionDetails { get; set; } | Obtiene o establece los detalles para cifrar el documento PDF de salida. |
| ExportDocumentStructure { get; set; } | Obtiene o establece un valor que determina si se debe exportar o no la estructura del documento. |
| ExportGeneratorName { get; set; } | Cuandoverdadero , hace que el nombre y la versión de Aspose.Words se incrusten en los archivos producidos. El valor predeterminado esverdadero . |
| ExportLanguageToSpanTag { get; set; } | Obtiene o establece un valor que determina si se debe crear o no una etiqueta “Span” en la estructura del documento para exportar el idioma del texto. |
| ExportParagraphGraphicsToArtifact { get; set; } | Obtiene o establece un valor que determina si un gráfico de párrafo debe marcarse como artefacto. |
| FontEmbeddingMode { get; set; } | Especifica el modo de incrustación de fuentes. |
| HeaderFooterBookmarksExportMode { get; set; } | Determina cómo se exportan los marcadores en encabezados y pies de página. |
| ImageColorSpaceExportMode { get; set; } | Especifica cómo se seleccionará el espacio de color para las imágenes en el documento PDF. |
| ImageCompression { get; set; } | Especifica el tipo de compresión que se utilizará para todas las imágenes del documento. |
| ImlRenderingMode { get; set; } | Obtiene o establece un valor que determina cómo se representan los objetos de tinta (InkML). |
| InterpolateImages { get; set; } | Una bandera que indica si la interpolación de imágenes debe ser realizada por un lector conforme. CuandoFALSO Si se especifica, la bandera no se escribe en el documento de salida y en su lugar se utiliza el comportamiento predeterminado del lector. |
| JpegQuality { get; set; } | Obtiene o establece un valor que determina la calidad de las imágenes JPEG dentro del documento PDF. |
| MemoryOptimization { get; set; } | Obtiene o establece un valor que determina si se debe realizar la optimización de la memoria antes de guardar el documento. El valor predeterminado para esta propiedad esFALSO . |
| MetafileRenderingOptions { get; set; } | Permite especificar opciones de representación de metarchivos. |
| NumeralFormat { get; set; } | Obtiene o estableceNumeralFormat Se utiliza para la representación de números. Los números europeos se utilizan de forma predeterminada. |
| OpenHyperlinksInNewWindow { get; set; } | Obtiene o establece un valor que determina si los hipervínculos en el documento Pdf de salida se fuerzan a abrirse en una nueva ventana (o pestaña) de un navegador. |
| virtual OptimizeOutput { get; set; } | El indicador indica si es necesario optimizar la salida. Si se establece este indicador, se eliminan los lienzos anidados redundantes y los lienzos vacíos, también se concatenan los glifos vecinos con el mismo formato. Nota: La precisión de la visualización del contenido puede verse afectada si esta propiedad se establece enverdadero . El valor predeterminado esFALSO . |
| OutlineOptions { get; } | Permite especificar opciones de contorno. |
| PageLayout { get; set; } | Especifica el diseño de página que se utilizará cuando el documento se abra en un lector de PDF. |
| PageMode { get; set; } | Especifica cómo debe mostrarse el documento PDF cuando se abre en un lector de PDF. |
| PageSavingCallback { get; set; } | Permite controlar cómo se guardan las páginas separadas cuando un documento se exporta a un formato de página fijo. |
| PageSet { get; set; } | Obtiene o establece las páginas que se representarán. El valor predeterminado son todas las páginas del documento. |
| PreblendImages { get; set; } | Obtiene o establece un valor que determina si se deben precombinar o no imágenes transparentes con color de fondo negro. |
| PreserveFormFields { get; set; } | Especifica si se deben conservar los campos de formulario de Microsoft Word como campos de formulario en PDF o convertirlos en texto. El valor predeterminado esFALSO . |
| PrettyFormat { get; set; } | Cuandoverdadero , formatos bonitos de salida donde corresponda. El valor predeterminado esFALSO . |
| ProgressCallback { get; set; } | Se llama al guardar un documento y acepta datos sobre el progreso del guardado. |
| RenderChoiceFormFieldBorder { get; set; } | Especifica si se debe representar el borde del campo de opción del formulario PDF. |
| override SaveFormat { get; set; } | Especifica el formato en el que se guardará el documento si se utiliza este objeto de opciones de guardado. Solo se puedePdf . |
| TempFolder { get; set; } | Especifica la carpeta para los archivos temporales utilizados al guardar en un archivo DOC o DOCX. De forma predeterminada, esta propiedad esnulo y no se utilizan archivos temporales. |
| TextCompression { get; set; } | Especifica el tipo de compresión que se utilizará para todo el contenido textual del documento. |
| UpdateAmbiguousTextFont { get; set; } | Determina si los atributos de fuente se cambiarán según el código de carácter que se esté utilizando. |
| UpdateCreatedTimeProperty { get; set; } | Obtiene o establece un valor que determina si elCreatedTime La propiedad se actualiza antes de guardar. El valor predeterminado esFALSO ; |
| UpdateFields { get; set; } | Obtiene o establece un valor que determina si los campos de ciertos tipos deben actualizarse antes de guardar el documento en un formato de página fijo. El valor predeterminado para esta propiedad esverdadero . |
| UpdateLastPrintedProperty { get; set; } | Obtiene o establece un valor que determina si elLastPrinted La propiedad se actualiza antes de guardar. |
| UpdateLastSavedTimeProperty { get; set; } | Obtiene o establece un valor que determina si elLastSavedTime La propiedad se actualiza antes de guardar. |
| UseAntiAliasing { get; set; } | Obtiene o establece un valor que determina si se debe utilizar o no suavizado para la representación. |
| UseBookFoldPrintingSettings { get; set; } | Obtiene o establece un valor booleano que indica si el documento debe guardarse utilizando un diseño de impresión de folleto, si se especifica medianteMultiplePages . |
| UseCoreFonts { get; set; } | Obtiene o establece un valor que determina si se deben sustituir o no las fuentes TrueType Arial, Times New Roman, Courier New y Symbol por las fuentes principales de PDF Type 1. |
| UseHighQualityRendering { get; set; } | Obtiene o establece un valor que determina si se deben utilizar o no algoritmos de renderizado de alta calidad (es decir, lentos). |
| UseSdtTagAsFormFieldName { get; set; } | Especifica si se debe utilizar la etiqueta de control SDT o la propiedad Id como nombre de un campo de formulario en PDF. |
| ZoomBehavior { get; set; } | Obtiene o establece un valor que determina qué tipo de zoom se debe aplicar cuando se abre un documento con un visor de PDF. |
| ZoomFactor { get; set; } | Obtiene o establece un valor que determina el factor de zoom (en porcentajes) para un documento. |
Métodos
| Nombre | Descripción |
|---|---|
| Clone() | Crea un clon profundo de este objeto. |
| override Equals(object) | Determina si el objeto especificado es igual en valor al objeto actual. |
Ejemplos
Muestra cómo cambiar el color de la imagen con la propiedad de opciones de guardado.
Document doc = new Document(MyDir + "Images.docx");
// Crea un objeto "PdfSaveOptions" que podamos pasar al método "Guardar" del documento
// para modificar la forma en que ese método convierte el documento a .PDF.
// Establezca la propiedad "ColorMode" en "Escala de grises" para representar todas las imágenes del documento en blanco y negro.
//El tamaño del documento de salida puede ser mayor con esta configuración.
// Establezca la propiedad "ColorMode" en "Normal" para representar todas las imágenes en color.
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions { ColorMode = colorMode };
doc.Save(ArtifactsDir + "PdfSaveOptions.ColorRendering.pdf", pdfSaveOptions);
Muestra cómo aplicar compresión de texto al guardar un documento en 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.");
// Crea un objeto "PdfSaveOptions" que podamos pasar al método "Guardar" del documento
// para modificar la forma en que ese método convierte el documento a .PDF.
PdfSaveOptions options = new PdfSaveOptions();
// Establezca la propiedad "TextCompression" en "PdfTextCompression.None" para no aplicar ninguna
//compresión a texto cuando guardamos el documento en PDF.
// Establezca la propiedad "TextCompression" en "PdfTextCompression.Flate" para aplicar la compresión ZIP
// al texto al guardar el documento en PDF. Cuanto más grande sea el documento, mayor será el impacto.
options.TextCompression = pdfTextCompression;
doc.Save(ArtifactsDir + "PdfSaveOptions.TextCompression.pdf", options);
Muestra cómo convertir un documento completo a PDF con tres niveles en el esquema del documento.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insertar encabezados de niveles 1 al 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");
// Crea un objeto "PdfSaveOptions" que podamos pasar al método "Guardar" del documento
// para modificar la forma en que ese método convierte el documento a .PDF.
PdfSaveOptions options = new PdfSaveOptions();
// El documento PDF de salida contendrá un esquema, que es una tabla de contenidos que enumera los encabezados en el cuerpo del documento.
// Al hacer clic en una entrada de este esquema accederemos a la ubicación de su encabezado respectivo.
// Establezca la propiedad "HeadingsOutlineLevels" en "4" para excluir del esquema todos los encabezados cuyos niveles sean superiores a 4.
options.OutlineOptions.HeadingsOutlineLevels = 4;
// Si una entrada de esquema tiene entradas subsiguientes de un nivel superior entre ella y la siguiente entrada del mismo nivel o de un nivel inferior,
Aparecerá una flecha a la izquierda de la entrada. Esta entrada es la "propietaria" de varias subentradas similares.
// En nuestro documento, las entradas del esquema del quinto nivel de encabezado son subentradas de la segunda entrada del esquema del cuarto nivel.
// las entradas de nivel de encabezado 4º y 5º son subentradas de la segunda entrada de nivel 3, y así sucesivamente.
// En el esquema, podemos hacer clic en la flecha de la entrada "propietario" para contraer/expandir todas sus subentradas.
// Establezca la propiedad "ExpandedOutlineLevels" en "2" para expandir automáticamente todas las entradas de encabezado de nivel 2 y de esquema inferior
// y colapsar todas las entradas de nivel 3 y superiores cuando abrimos el documento.
options.OutlineOptions.ExpandedOutlineLevels = 2;
doc.Save(ArtifactsDir + "PdfSaveOptions.ExpandedOutlineLevels.pdf", options);
Ver también
- class FixedPageSaveOptions
- espacio de nombres Aspose.Words.Saving
- asamblea Aspose.Words
