Aspose::Pdf::HtmlSaveOptions class

HtmlSaveOptions class

Opciones de guardado para exportar al formato HTML.

class HtmlSaveOptions : public Aspose::Pdf::UnifiedSaveOptions,
                        public Aspose::Pdf::IPageSetOptions,
                        public Aspose::Pdf::IPipelineOptions

Nested classes

Enums

Enumeración	Descripción
AntialiasingProcessingType	Este enum describe posibles medidas de antialiasing durante la conversión.
FontEncodingRules	Esta enumeración define reglas que afinan la lógica de codificación.
FontSavingModes	Enumera los modos que pueden usarse para guardar fuentes referenciadas en el PDF guardado.
HtmlImageType	Enumera los tipos posibles de archivos de imagen que pueden guardarse como recursos externos durante la conversión de Pdf a Html.
HtmlMarkupGenerationModes	A veces existen requisitos específicos para el HTML creado. Este enum define los modos de preparación de HTML que pueden usarse durante la conversión de PDF a HTML para cumplir con dichos requisitos específicos.
ImageParentTypes	Enumera los tipos posibles de padres de imágenes que Image puede pertenecer a una página HTML o a una imagen padre SVG.
LettersPositioningMethods	Enumera los modos posibles de posicionamiento de letras en palabras en el HTML resultante.
PartsEmbeddingModes	Este enum enumera los modos posibles de incrustación de archivos referenciados en HTML. Permite controlar si los archivos referenciados (HTML, fuentes, imágenes, CSS) se incrustarán en el archivo HTML principal o se generarán como entidades binarias separadas.
RasterImagesSavingModes	El PDF convertido puede contener imágenes raster (.png, *.jpeg, etc.). Este enum define los métodos de cómo pueden manejarse las imágenes raster durante la conversión de PDF a HTML.

Métodos

Método	Descripción
get_AdditionalMarginWidthInPoints() const	Si el atributo ‘SplitOnPages=false’, entonces todo el HTML que representa todas las páginas PDF de entrada no se dividirá en diferentes páginas HTML, sino que se colocará en un único archivo HTML resultante grande. Pero cada página PDF origen se representará con su propia área rectangular en HTML (si es necesario, esas áreas pueden estar delimitadas para mostrar los bordes del papel de la página con el atributo especial ‘PageBorderIfAny’). Este parámetro define el ancho del margen que se dejará obligatoriamente alrededor de esas áreas HTML de salida que representan las páginas del documento PDF origen. En esencia, define el intervalo garantizado entre las representaciones HTML de las páginas “paper” del PDF en dicho modo de conversión.
get_BatchSize() override	Define el tamaño del lote si la conversión por lotes es aplicable al par de formatos de origen y destino.
get_CompressSvgGraphicsIfAny() const	Obtiene la bandera que indica si los gráficos SVG encontrados (si los hay) se comprimirán (en zip) al formato SVGZ durante el guardado.
get_ConvertMarkedContentToLayers() const	Si el atributo ConvertMarkedContentToLayers está configurado a true, entonces todos los elementos dentro de un contenido marcado PDF (capa) se colocarán en un div HTML con el atributo “data-pdflayer” que especifica un nombre de capa. Este nombre de capa se extraerá de las propiedades opcionales del contenido marcado PDF. Si este atributo es false (por defecto), entonces no se crearán capas a partir del contenido marcado PDF.
get_DefaultFontName() const	Especifica el nombre de una fuente instalada que se usa para sustituir cualquier fuente del documento que no esté incrustada y no esté instalada en el sistema. Si es null, se usará la fuente de sustitución predeterminada.
get_DocumentType() const	Obtiene el HtmlDocumentType.
get_ExplicitListOfSavedPages() override	Con esta propiedad puedes definir explícitamente qué páginas del documento deben convertirse. Las páginas en esta lista deben tener números basados en 1. Es decir, los números válidos de páginas deben tomarse del rango (1…[NumberOfPagesInConvertedDocument]). El orden de aparición de las páginas en esta lista no afecta su orden en la(s) página(s) HTML resultante(s); en las páginas resultantes siempre se mantendrá el orden en que aparecen en el PDF de origen. Si esta lista es nula (como es por defecto), se convertirán todas las páginas. Si algún número de página de esta lista está fuera del rango de páginas presentes (1-[amountOfPagesInDocument]) se lanzará una excepción.
get_FixedLayout() const	Obtiene un valor que indica si ese HTML se crea como diseño fijo.
get_FlowLayoutParagraphFullWidth() const	Este atributo especifica texto de párrafo de ancho completo para el modo Flow, FixedLayout = false.
get_FontSources() const	Fuentes de origen de fuentes preguardadas.
get_IgnoredTextFontSize() const	Text con el tamaño especificado o menor será ignorado durante la conversión. No eliminamos este texto, lo ignoramos y no lo transferimos al archivo de salida.
get_IgnoreResourceFontErrors() const	Obtiene la indicación de que los errores relacionados con la ausencia de fuentes serán ignorados. true - significa que los errores de ausencia de fuentes serán ignorados. Los segmentos de Text que hacen referencia a recursos incorrectos se omitirán durante el procesamiento. false por defecto.
get_ImageResolution() const	Obtiene la resolución para la renderización de imágenes.
get_MinimalLineWidth() const	Este atributo establece el ancho mínimo de la línea de la ruta gráfica. Si el grosor de la línea es inferior a 1 px, Adobe Acrobat lo redondea a este valor. Por lo tanto, este atributo puede usarse para emular este comportamiento en navegadores HTML.
get_PreventGlyphsGrouping() const	Este atributo activa el modo en el que los glifos de texto no se agruparán en palabras y cadenas. Este modo permite mantener la máxima precisión al posicionar los glifos en la página y puede usarse para convertir documentos con notas musicales o glifos que deben colocarse por separado. Este parámetro se aplicará al documento solo cuando el valor del atributo FixedLayout sea true.
get_RenderTextAsImage() const	Si el atributo RenderTextAsImage se establece en true, el texto de origen se convierte en una imagen en HTML. Puede ser útil para hacer que el texto no sea seleccionable o cuando el texto HTML no se renderiza correctamente.
get_SaveFullFont() const	Indica que se guardará la fuente completa, solo admite fuentes True Type. Por defecto, SaveFullFont = false y el convertidor guarda el subconjunto de la fuente inicial necesario para mostrar el texto del documento.
get_SimpleTextboxModeGrouping() const	Este atributo especifica una agrupación secuencial de glifos y palabras en cadenas. Por ejemplo, las etiquetas y las palabras tienen un orden diferente en el HTML convertido y deseas que coincidan. Este parámetro se aplicará al documento solo cuando el valor del atributo FixedLayout sea true.
get_SplitCssIntoPages() const	Cuando se selecciona el modo multipágina (es decir, ‘SplitIntoPages’ es ’true’), este atributo define si se debe crear un archivo CSS separado para cada página HTML resultante. Por defecto, este atributo es false, por lo que se crea un único CSS común para todas las páginas creadas. El tamaño total de todos los CSS generados en este modo (un CSS por página) suele ser mucho mayor que el tamaño de un único CSS grande, porque en el primer caso las clases CSS se duplican en varios archivos CSS para cada página. Por lo tanto, esta configuración solo debería usarse cuando estés interesado en procesar cada página HTML de forma independiente en el futuro, y por consiguiente el tamaño del CSS de cada página individual sea el factor más crítico.
get_SplitIntoPages() const	Obtiene la bandera que indica si cada página del documento fuente se convertirá en su propio documento HTML de destino, es decir, si el HTML resultante se dividirá en varias páginas HTML.
get_Title() const	Obtiene el título de la página HTML.
get_TryMergeFragments() const	La bandera para combinar fragmentos de imagen en una sola imagen.
get_UseZOrder() const	Si el atributo UseZORder se establece en true, los gráficos y el texto se añaden al documento HTML resultante de acuerdo con el orden Z del documento PDF original. Si este atributo es false, todos los gráficos se colocan en una sola capa, lo que puede causar efectos innecesarios en objetos superpuestos.
HtmlSaveOptions()	Inicializa una nueva instancia de la clase HtmlSaveOptions.
HtmlSaveOptions(HtmlDocumentType)	Inicializa una nueva instancia de la clase HtmlSaveOptions.
HtmlSaveOptions(bool)	Inicializa una nueva instancia de la clase HtmlSaveOptions.
HtmlSaveOptions(HtmlDocumentType, bool)	Inicializa una nueva instancia de la clase HtmlSaveOptions.
set_AdditionalMarginWidthInPoints(int32_t)	Si el atributo ‘SplitOnPages=false’, entonces todo el HTML que representa todas las páginas PDF de entrada no se dividirá en diferentes páginas HTML, sino que se colocará en un único archivo HTML resultante grande. Pero cada página PDF origen se representará con su propia área rectangular en HTML (si es necesario, esas áreas pueden estar delimitadas para mostrar los bordes del papel de la página con el atributo especial ‘PageBorderIfAny’). Este parámetro define el ancho del margen que se dejará obligatoriamente alrededor de esas áreas HTML de salida que representan las páginas del documento PDF origen. En esencia, define el intervalo garantizado entre las representaciones HTML de las páginas “paper” del PDF en dicho modo de conversión.
set_BatchSize(int32_t) override	Define el tamaño del lote si la conversión por lotes es aplicable al par de formatos de origen y destino.
set_CompressSvgGraphicsIfAny(bool)	Establece la bandera que indica si los gráficos SVG encontrados (si los hay) se comprimirán (zipped) en formato SVGZ durante el guardado.
set_ConvertMarkedContentToLayers(bool)	Si el atributo ConvertMarkedContentToLayers está configurado a true, entonces todos los elementos dentro de un contenido marcado PDF (capa) se colocarán en un div HTML con el atributo “data-pdflayer” que especifica un nombre de capa. Este nombre de capa se extraerá de las propiedades opcionales del contenido marcado PDF. Si este atributo es false (por defecto), entonces no se crearán capas a partir del contenido marcado PDF.
set_DefaultFontName(const System::String&)	Especifica el nombre de una fuente instalada que se usa para sustituir cualquier fuente del documento que no esté incrustada y no esté instalada en el sistema. Si es null, se usará la fuente de sustitución predeterminada.
set_DocumentType(HtmlDocumentType)	Establece el HtmlDocumentType.
set_ExplicitListOfSavedPages(System::ArrayPtr<int32_t>) override	Con esta propiedad puedes definir explícitamente qué páginas del documento deben convertirse. Las páginas en esta lista deben tener números basados en 1. Es decir, los números válidos de páginas deben tomarse del rango (1…[NumberOfPagesInConvertedDocument]). El orden de aparición de las páginas en esta lista no afecta su orden en la(s) página(s) HTML resultante(s); en las páginas resultantes siempre se mantendrá el orden en que aparecen en el PDF de origen. Si esta lista es nula (como es por defecto), se convertirán todas las páginas. Si algún número de página de esta lista está fuera del rango de páginas presentes (1-[amountOfPagesInDocument]) se lanzará una excepción.
set_FixedLayout(bool)	Establece un valor que indica si ese HTML se crea como diseño fijo.
set_FlowLayoutParagraphFullWidth(bool)	Este atributo especifica texto de párrafo de ancho completo para el modo Flow, FixedLayout = false.
set_IgnoredTextFontSize(System::Nullable<float>)	Text con el tamaño especificado o menor será ignorado durante la conversión. No eliminamos este texto, lo ignoramos y no lo transferimos al archivo de salida.
set_IgnoreResourceFontErrors(bool)	Establece la indicación de que los errores relacionados con la ausencia de fuentes serán ignorados. true - significa que los errores de ausencia de fuentes serán ignorados. Los segmentos de Text que hacen referencia a recursos incorrectos se omitirán durante el procesamiento. false por defecto.
set_ImageResolution(int32_t)	Establece la resolución para la renderización de imágenes.
set_MinimalLineWidth(float)	Este atributo establece el ancho mínimo de la línea de la ruta gráfica. Si el grosor de la línea es inferior a 1 px, Adobe Acrobat lo redondea a este valor. Por lo tanto, este atributo puede usarse para emular este comportamiento en navegadores HTML.
set_PreventGlyphsGrouping(bool)	Este atributo activa el modo en el que los glifos de texto no se agruparán en palabras y cadenas. Este modo permite mantener la máxima precisión al posicionar los glifos en la página y puede usarse para convertir documentos con notas musicales o glifos que deben colocarse por separado. Este parámetro se aplicará al documento solo cuando el valor del atributo FixedLayout sea true.
set_RenderTextAsImage(bool)	Si el atributo RenderTextAsImage se establece en true, el texto de origen se convierte en una imagen en HTML. Puede ser útil para hacer que el texto no sea seleccionable o cuando el texto HTML no se renderiza correctamente.
set_SaveFullFont(bool)	Indica que se guardará la fuente completa, solo admite fuentes True Type. Por defecto, SaveFullFont = false y el convertidor guarda el subconjunto de la fuente inicial necesario para mostrar el texto del documento.
set_SimpleTextboxModeGrouping(bool)	Este atributo especifica una agrupación secuencial de glifos y palabras en cadenas. Por ejemplo, las etiquetas y las palabras tienen un orden diferente en el HTML convertido y deseas que coincidan. Este parámetro se aplicará al documento solo cuando el valor del atributo FixedLayout sea true.
set_SplitCssIntoPages(bool)	Cuando se selecciona el modo multipágina (es decir, ‘SplitIntoPages’ es ’true’), este atributo define si se debe crear un archivo CSS separado para cada página HTML resultante. Por defecto, este atributo es false, por lo que se crea un único CSS común para todas las páginas creadas. El tamaño total de todos los CSS generados en este modo (un CSS por página) suele ser mucho mayor que el tamaño de un único CSS grande, porque en el primer caso las clases CSS se duplican en varios archivos CSS para cada página. Por lo tanto, esta configuración solo debería usarse cuando estés interesado en procesar cada página HTML de forma independiente en el futuro, y por consiguiente el tamaño del CSS de cada página individual sea el factor más crítico.
set_SplitIntoPages(bool)	Establece la bandera que indica si cada página del documento fuente se convertirá en su propio documento HTML de destino, es decir, si el HTML resultante se dividirá en varias páginas HTML.
set_Title(const System::String&)	Establece el título de la página HTML.
set_TryMergeFragments(bool)	La bandera para combinar fragmentos de imagen en una sola imagen.
set_UseZOrder(bool)	Si el atributo UseZORder se establece en true, los gráficos y el texto se añaden al documento HTML resultante de acuerdo con el orden Z del documento PDF original. Si este atributo es false, todos los gráficos se colocan en una sola capa, lo que puede causar efectos innecesarios en objetos superpuestos.

Typedefs

Typedef	Descripción
CssSavingStrategy	Puede asignar a esta propiedad una estrategia personalizada que implemente el procesamiento y/o guardado de una parte de CSS que se creó durante la conversión de PDF a HTML. En tal caso, el procesamiento (como guardar en un flujo o en disco) debe realizarse en ese código personalizado.
CssUrlMakingStrategy	Puede asignar a esta propiedad un delegado creado a partir de un método personalizado que implemente la creación de la URL del CSS referenciado en el documento HTML generado. Por ejemplo, si desea que el CSS sea referenciado en HTML, por ejemplo como “otherPage.ASPX?CssID=zjjkklj”, entonces dicha estrategia personalizada debe devolver “otherPage.ASPX?CssID=zjjkklj”.
HtmlPageMarkupSavingStrategy	El resultado de la conversión puede contener una o varias páginas HTML (que también pueden referenciar archivos externos como imágenes o fuentes). Puede asignar a esta propiedad un delegado creado a partir de un método personalizado que implemente el procesamiento de la página HTML obtenida (el propio HTML) que se creó durante la conversión. En tal caso, el procesamiento (como guardar en un flujo o en disco) puede realizarse en ese código personalizado. En tal caso, todas las acciones necesarias para guardar el marcado de la página HTML deben llevarse a cabo en el código del método suministrado, porque el guardado del resultado en el código del convertidor no se utilizará. Si el procesamiento para este u otro caso, por alguna razón, debe ser realizado por el código del convertidor mismo, no en el código personalizado, establezca en el código personalizado la bandera ‘CustomProcessingCancelled’ de la variable del parámetro ‘htmlSavingInfo’: indica al convertidor que todos los pasos necesarios para procesar ese recurso deben realizarse en el propio convertidor de la misma manera que si no hubiera ningún código de guardado externo personalizado.
ResourceSavingStrategy	A esta propiedad puede asignar un delegado creado a partir de un método personalizado que implemente el procesamiento de un recurso externo (fuente o imagen) que se extrajo del PDF y debe guardarse como recurso externo durante la conversión de PDF a HTML. En tal caso, el procesamiento (como guardar en un flujo o en disco) puede realizarse en ese código personalizado y dicho código debe devolver la ruta (u otra cadena sin comillas) que posteriormente se incorporará al HTML generado en lugar de la ruta original supuesta del recurso de imagen. En tal caso, todas las acciones necesarias para guardar la imagen deben llevarse a cabo en el código del método suministrado, porque el guardado del resultado en el código del convertidor no se utilizará. Si el procesamiento para este u otro archivo, por alguna razón, debe ser realizado por el código del convertidor mismo, no en el código personalizado, establezca en el código personalizado la bandera ‘CustomProcessingCancelled’ de la variable del parámetro ‘resourceSavingInfo’. Indica al convertidor que todos los pasos necesarios para procesar ese recurso deben realizarse en el propio convertidor como si no hubiera ningún código externo personalizado.

Ver también

Clase Aspose::Pdf::HtmlLoadOptions Aspose::Pdf::Hyperlink clase