HtmlSaveOptions

HtmlSaveOptions class

Salva le opzioni per l’esportazione in formato HTML

public class HtmlSaveOptions : UnifiedSaveOptions, IPageSetOptions, IPipelineOptions

Costruttori

NomeDescrizione
HtmlSaveOptions()Inizializza una nuova istanza diHtmlSaveOptions classe.
HtmlSaveOptions(bool)Inizializza una nuova istanza diHtmlSaveOptions classe.
HtmlSaveOptions(HtmlDocumentType)Inizializza una nuova istanza diHtmlSaveOptions classe.
HtmlSaveOptions(HtmlDocumentType, bool)Inizializza una nuova istanza diHtmlSaveOptions classe.

Proprietà

NomeDescrizione
BatchSize { get; set; }Definisce la dimensione batch se la conversione batch è applicabile alla coppia di formati di origine e destinazione.
CloseResponse { get; set; }Ottiene o imposta il valore booleano che indica che l’oggetto Response verrà chiuso dopo che il documento verrà salvato nella risposta.
CompressSvgGraphicsIfAny { get; set; }Ottiene o imposta il flag che indica se ha trovato la grafica SVG (se presente) verrà compressa (zippata) nel formato SVGZ durante il salvataggio
ConvertMarkedContentToLayers { get; set; }Se l’attributo ConvertMarkedContentToLayers è impostato su true, tutti gli elementi all’interno di un contenuto PDF contrassegnato (livello) verranno inseriti in un div HTML con l’attributo “data-pdflayer” che specifica un nome di livello. Questo nome di livello verrà estratto dalle proprietà opzionali del PDF contenuto contrassegnato. Se questo attributo è false (per impostazione predefinita), non verrà creato alcun livello dal contenuto contrassegnato PDF.
DefaultFontName { get; set; }Specifica il nome di un font installato che viene utilizzato per sostituire qualsiasi font del documento non incorporato e non installato nel sistema. Se null viene utilizzato il carattere di sostituzione predefinito.
DocumentType { get; set; }Ottiene o imposta ilHtmlDocumentType .
ExplicitListOfSavedPages { get; set; }Con questa proprietà è possibile definire in modo esplicito quali pagine del documento devono essere convertite. Le pagine in questo elenco devono avere numeri in base 1. Vale a dire numeri validi di pagine devono essere presi dall’intervallo (1…[NumberOfPagesInConvertedDocument]) L’ordine di visualizzazione delle pagine in questo elenco non influisce sul loro ordine nelle pagine HTML dei risultati - nelle pagine dei risultati andranno sempre in ordine in cui sono presenti nel PDF di origine. Se questo elenco è nullo (come è per impostazione predefinita), tutte le pagine verranno convertite. Se qualsiasi numero di pagina di questo elenco andrà fuori dall’intervallo delle pagine presenti (1-[ verrà generata un’eccezione amountOfPagesInDocument]) .
ExtractOcrSublayerOnly { get; set; }Questo attributo ha attivato la funzionalità per l’estrazione di immagini o testo per documenti PDF con sottolivello OCR.
FixedLayout { get; set; }Ottiene o imposta un valore che indica se l’HTML viene creato come layout fisso.
FlowLayoutParagraphFullWidth { get; set; }Questo attributo specifica il testo del paragrafo a larghezza intera per la modalità Flusso, FixedLayout = false
FontSources { get; }Fonti dei caratteri pre-salvati.
ImageResolution { get; set; }Ottiene o imposta la risoluzione per il rendering delle immagini.
MinimalLineWidth { get; set; }Questo attributo imposta la larghezza minima della linea del percorso grafico. Se lo spessore della linea è inferiore a 1px Adobe Acrobat lo arrotonda a questo valore. Quindi questo attributo può essere utilizzato per emulare questo comportamento per i browser HTML.
PreventGlyphsGrouping { get; set; }Questo attributo attiva la modalità quando i glifi di testo non vengono raggruppati in parole e stringhe Questa modalità consente di mantenere la massima precisione durante il posizionamento dei glifi sulla pagina e può essere utilizzata per la conversione di documenti con note musicali o glifi da posizionare separatamente a vicenda. Questo parametro verrà applicato al documento solo quando il valore dell’attributo FixedLayout è true.
RenderTextAsImage { get; set; }Se l’attributo RenderTextAsImage è impostato su true, il testo della sorgente diventa un’immagine in HTML. Potrebbe essere utile rendere il testo non selezionabile o il testo HTML non viene visualizzato correttamente.
SaveFormat { get; }Formato di salvataggio dei dati.
SimpleTextboxModeGrouping { get; set; }Questo attributo specifica un raggruppamento sequenziale di glifi e parole in stringhe Ad esempio tag e parole hanno un ordine diverso nell’HTML convertito e si desidera che corrispondano. Questo parametro verrà applicato al documento solo quando il valore dell’attributo FixedLayout è true.
SplitCssIntoPages { get; set; }Quando è selezionata la modalità multipagina (cioè ‘SplitIntoPages’ è ’true’), quindi questo attributo definisce se deve essere creato un file CSS separato per ogni pagina HTML di risultato. Per impostazione predefinita questo attributo è false, quindi verrà creato uno grande CSS comune per tutte le pagine create. Dimensione di riepilogo di tutti CSS generati in questa modalità (un CSS per pagina) solitamente molto più della dimensione di un grande file CSS, perché nel primo caso le classi CSS sono duplicate in questo caso in diversi file CSS per ogni pagina. Quindi, questo l’impostazione è peggio da usare solo quando sei interessato all’elaborazione futura di ciascuna pagina HTML in modo indipendente, e quindi la dimensione di CSS di ogni pagina smontata è il problema più critico.
SplitIntoPages { get; set; }Ottiene o imposta il flag che indica se ogni pagina del documento di origine verrà convertita nel proprio documento HTML di destinazione, cioè se il risultato HTML verrà suddiviso in più pagine HTML.
UseZOrder { get; set; }Se l’attributo UseZORder è impostato su true, la grafica e il testo vengono aggiunti al documento HTML risultante di conseguenza l’ordine Z nel documento PDF originale. Se questo attributo è false, tutta la grafica viene inserita come livello singolo che potrebbe causare alcuni effetti non necessari per oggetti sovrapposti.
WarningHandler { get; set; }Richiamata per gestire eventuali avvisi generati. WarningHandler restituisce l’elemento enum ReturnAction specificando Continue o Abort. Continua è l’azione predefinita e l’operazione di salvataggio continua, tuttavia l’utente può anche restituire Interrompi, nel qual caso l’operazione di salvataggio dovrebbe cessare.

Campi

NomeDescrizione
AntialiasingProcessingQuesto parametro definisce le misure di antialiasing richieste durante la conversione di immagini di sfondo composte da PDF a HTML
CssClassNamesPrefixQuando il convertitore PDFtoHTML genera risultati CSS, i nomi delle classi CSS (qualcosa come “.stl_01 {}” … “.stl_NN {}) vengono generati e utilizzati nei risultati CSS. Questa proprietà consente di impostare in modo forzato il prefisso del nome della classe Ad esempio, se si vuoi che tutti i nomi delle classi inizino con ‘my_prefix_’ (cioè erano qualcosa come ‘my_prefix_1’ … ‘my_prefix_NNN’ ), quindi basta assegnare ‘my_prefix_’ a questa proprietà prima della conversione. Se questa proprietà rimarrà intatta (cioè null verrà lasciato come valore), quindi il convertitore genererà i nomi delle classi (sarà qualcosa come “.stl_01 {}” … “.stl_NN {}”)
CustomCssSavingStrategyQuesto campo può contenere la strategia di salvataggio che deve essere utilizzata (se presente) durante la conversione di Pdf in Html per la gestione del salvataggio dei CSS relativi all’intero documento HTML creato o alle sue pagine (se vengono generate più pagine HTML) Se vuoi gestire il file CSS in un modo specifico, creando semplicemente un metodo pertinente e assegna il delegato creato da esso a questa proprietà.
CustomHtmlSavingStrategyIl risultato della conversione può contenere una o più pagine HTML È possibile assegnare a questa proprietà un delegato creato da un metodo personalizzato che implementa l’elaborazione di una pagina HTML (per essere precisi - markup-HTML, senza eventuali file collegati esterni) che è stato creato durante la conversione. In tal caso l’elaborazione (come il salvataggio dell’HTML della pagina nello stream o nel disco) può essere eseguita in quel codice personalizzato. In tal caso tutte le azioni necessarie per il salvataggio della pagina HTML devono essere eseguite nel codice del metodo fornito, poiché il salvataggio del risultato nel codice del convertitore non sarà utilizzato. Se l’elaborazione per questo o quel caso per qualche motivo deve essere eseguita dal codice del convertitore stesso, non nel codice personalizzato, impostare nel codice personalizzato il flag ‘CustomProcessingCancelled’ della variabile del parametro ‘htmlSavingInfo’: segnalerà al convertitore che tutti i i passaggi necessari per l’elaborazione di quella risorsa devono essere eseguiti nel convertitore stesso allo stesso modo come se non ci fosse alcun codice personalizzato esterno per l’elaborazione .
CustomProgressHandlerQuesto gestore può essere utilizzato per gestire gli eventi di avanzamento della conversione fe può essere utilizzato per mostrare la barra di avanzamento o messaggi sulla quantità corrente di pagine elaborate, esempio di codice del gestore che mostra l’avanzamento sulla console è :
CustomResourceSavingStrategyQuesto campo può contenere la strategia di salvataggio che deve essere utilizzata (se presente) durante la conversione per la gestione personalizzata dei file di risorse di riferimento creati (come immagini e font) relativi a nodi di HTML salvati. Tale strategia deve elaborare le risorse e restituire la stringa che rappresenta l’URL desiderabile della risorsa salvata nell’HTML generato.
CustomStrategyOfCssUrlCreationQuesto campo può contenere un metodo personalizzato che restituisce l’URL (o il modello di URL se è attiva la generazione di più pagine - vedere i dettagli di seguito) del soggetto CSS come dovrebbe essere inserito nel risultato generato HTML. Fe se vuoi il convertitore inserisci un URL specifico invece di standard Il nome del file CSS nel CSS generato, quindi dovresti semplicemente creare e inserire questa proprietà method che genera l’URL desiderabile. Se flag ‘SplitCssIntoPages’ impostato, allora questa strategia personalizzata (se presente) deve restituire non l’URL esatto del CSS ma piuttosto il modello string that (dopo la sostituzione del segnaposto con il numero di pagina con la funzione string.Format() all’interno del convertitore) può essere risolta in URL per questa o quella pagina CSS’ URL. Esempi di stringa di ritorno prevista in questo caso sono: ‘SomeTargetLocation-page_{0}.css’,’../PartHandlers/GetCss.aspx?DocumentId=45654&CssPage={0}’)
ExcludeFontNameListElenco di nomi di font incorporati PDF che non possono essere incorporati in HTML.
FontEncodingStrategyDefinisce la regola speciale di codifica per ottimizzare la decodifica PDF per il documento corrente
FontSavingModeDefinisce la modalità di salvataggio dei caratteri che verrà utilizzata durante il salvataggio del PDF nel formato desiderato
HtmlMarkupGenerationModeA volte sono presenti requisiti specifici per la generazione di markup HTML. Questo parametro definisce le modalità di preparazione HTML che possono essere utilizzate durante la conversione di PDF in HTML per soddisfare tali requisiti specifici.
LettersPositioningMethodImposta la modalità di posizionamento delle lettere nelle parole nel risultato HTML
PageBorderIfAnyQuesto attributo rappresenta l’insieme di impostazioni utilizzate per disegnare il bordo (se presente) nel documento HTML risultante intorno all’area che rappresenta la pagina PDF di origine. In sostanza si tratta di mostrare i bordi della carta della pagina, non il bordo della pagina a cui si fa riferimento nella pagina PDF stessa.
PageMarginIfAnyQuesto attributo rappresenta l’insieme del margine di pagina aggiuntivo (se presente) nel documento HTML risultante attorno all’area che rappresenta la pagina PDF di origine.
PagesFlowTypeDependsOnViewersScreenSizeSe l’attributo ‘SplitOnPages=false’, l’intero HTML che rappresenta tutte le pagine PDF di input verrà inserito in un file HTML di grandi risultati. Questo flag definisce se il risultato HTML verrà generato in modo tale che il flusso di aree che rappresentano le pagine PDF nel risultato HTML dipenderà dalla risoluzione dello schermo del visualizzatore. Supponiamo che la larghezza dello schermo sul lato visualizzatore sia abbastanza grande da mettere 2 o più pagine una vicino a l’altra in direzione orizzontale. Se questo flag è impostato su true, verrà utilizzata questa opportunità (verranno mostrate quante più pagine possibile in direzione orizzontale una vicino a un’altra , quindi il prossimo gruppo orizzontale di pagine verrà mostrato sotto il primo). Altrimenti le pagine scorreranno dentro in questo modo: la pagina successiva va sempre sotto la precedente.
PartsEmbeddingModeDefinisce se i file di riferimento (HTML, Font, Immagini, CSS) verranno incorporati nel file HTML principale o verranno generati come entità binarie separate
RasterImagesSavingModeIl PDF convertito può contenere immagini raster Questo parametro definisce come devono essere gestiti durante la conversione del PDF in HTML
RemoveEmptyAreasOnTopAndBottomDefinisce se nell’HTML creato verrà rimossa l’area vuota superiore e inferiore senza alcun contenuto (se presente).
SaveFullFontIndica che verrà salvato il font completo, supporta solo i font True Type. Per impostazione predefinita SaveFullFont = false e il convertitore salva il sottoinsieme del font iniziale necessario per visualizzare il testo del documento.
SaveShadowedTextsAsTransparentTextsPdf può contenere testi che sono ombreggiati da altri elementi (es. immagini) ma può essere selezionato negli appunti in Acrobat Reader (di solito accade quando il documento contiene immagini e testi OCR estratti da esso). Questa impostazione dice al convertitore se dobbiamo è necessario salvare tali testi come testi trasparenti selezionabili nel risultato HTML per imitare il comportamento di Acrobat Reader (altrimenti tali testi vengono solitamente salvati come nascosti, non disponibili per la copia negli appunti)
SaveTransparentTextsPdf può contenere testi trasparenti che possono essere selezionati negli appunti (di solito accade quando il documento contiene immagini e testi OCR estratti da esso). Questa impostazione indica al convertitore se è necessario salvare tali testi come trasparenti testi selezionabili nel risultato HTML
SpecialFolderForAllImagesOttiene o imposta il percorso della directory in cui devono essere salvate le immagini se vengono incontrate durante il salvataggio del documento come HTML. Se il parametro è vuoto o null , i file immagine (se presenti) verranno salvati insieme ad altri file collegati a HTML Non ha alcun effetto se la proprietà CustomImageSavingStrategy è stata utilizzata correttamente per elaborare il file immagine rilevante.
SpecialFolderForSvgImagesOttiene o imposta il percorso della directory in cui devono essere salvate solo le immagini SVG se vengono incontrate durante il salvataggio del documento come HTML. Se il parametro è vuoto o null , i file SVG (se presenti) verranno salvati insieme ad altri file di immagine (vicino al file di output) o in una cartella speciale per le immagini (se specificata nell’opzione SpecialImagesFolderIfAny). Non influisce su nulla se la proprietà CustomImageSavingStrategy è stata utilizzata correttamente per elaborare il file immagine pertinente.
TryMergeAdjacentSameBackgroundImagesA volte i PDF contengono immagini di sfondo (di pagine o celle di tabella) costruite da diverse immagini di sfondo affiancate dalla stessa piastrellatura. In tal caso i renderer di formati target (ad esempio MsWord per il formato DOCS) generano talvolta confini visibili tra parti di immagini di sfondo , perché le loro tecniche di smussamento dei bordi dell’immagine (anti-aliasing) sono diverse da Acrobat Reader. Se sembra che il documento esportato contenga limiti così visibili tra parti delle stesse immagini di sfondo, prova a utilizzare questa impostazione per eliminare di quello effetto indesiderato. ATTENZIONE! Questa ottimizzazione della qualità di solito rallenta sostanzialmente la conversione, quindi, per favore, usa questa opzione solo quando è veramente necessario.
TrySaveTextUnderliningAndStrikeoutingInCssIl PDF stesso non contiene marcatori di sottolineatura per i testi. Emulato con una riga situata sotto il testo. Questa opzione consente al convertitore di provare a indovinare che questa o quella riga è una sottolineatura di un testo e inserire queste informazioni in CSS invece di disegnare o sottolineare graficamente

Guarda anche