DocumentSplitCriteria

DocumentSplitCriteria enumeration

Specifica come il documento viene suddiviso in parti durante il salvataggioHtml , Epub OAzw3 formato.

[Flags]
public enum DocumentSplitCriteria

I valori

NomeValoreDescrizione
None0Il documento non è diviso.
PageBreak1Il documento è diviso in parti con interruzioni di pagina esplicite. Un’interruzione di pagina può essere specificata da unPageBreak carattere, un’interruzione di sezione che specifica l’inizio di una nuova sezione su una nuova pagina, o un paragrafo che ha il suoPageBreakBefore proprietà impostata suVERO .
ColumnBreak2Il documento viene diviso in parti in base alle interruzioni di colonna. Un’interruzione di colonna può essere specificata da unColumnBreak carattere or un’interruzione di sezione che specifica l’inizio di una nuova sezione in una nuova colonna.
SectionBreak4Il documento è diviso in parti in corrispondenza di un’interruzione di sezione di qualsiasi tipo.
HeadingParagraph8Il documento è diviso in parti in un paragrafo formattato utilizzando uno stile di intestazioneTitolo 1 ,Titolo 2 ecc. Da usare insieme aDocumentSplitHeadingLevel per specificare i livelli di intestazione (da 1 al livello specificato) in cui effettuare la divisione.

Osservazioni

DocumentSplitCriteriaè un insieme di flag che possono essere combinati. Ad esempio, è possibile suddividere il documento document in interruzioni di pagina e in intestazioni di paragrafo nella stessa operazione di esportazione.

Diversi criteri possono sovrapporsi parzialmente. Ad esempio,Titolo 1 allo stile viene spesso assegnato PageBreakBefore proprietà, quindi rientra in due criteri:PageBreak e HeadingParagraphAlcune interruzioni di sezione possono causare interruzioni di pagina e così via. In casi tipici, specificare un solo flag è l’opzione più pratica.

Esempi

Mostra come utilizzare una codifica specifica quando si salva un documento in formato .epub.

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

// Utilizzare un oggetto SaveOptions per specificare la codifica per un documento che salveremo.
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.SaveFormat = SaveFormat.Epub;
saveOptions.Encoding = Encoding.UTF8;

// Per impostazione predefinita, un documento .epub di output avrà tutto il suo contenuto in una parte HTML.
// Un criterio di suddivisione consente di segmentare il documento in più parti HTML.
// Imposteremo i criteri per suddividere il documento in paragrafi di intestazione.
// Questa funzione è utile per i lettori che non riescono a leggere file HTML di dimensioni superiori a una determinata soglia.
saveOptions.DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph;

// Specificare che si desidera esportare le proprietà del documento.
saveOptions.ExportDocumentProperties = true;

doc.Save(ArtifactsDir + "HtmlSaveOptions.Doc2EpubSaveOptions.epub", saveOptions);

Guarda anche