Layout della pagina immagine
Layout della Pagina Immagine
Questa pagina documenta la classe di configurazione MultiPageLayout e le sue enumerazioni correlate al rendering delle immagini, e spiega perché non hanno un percorso di salvataggio funzionale in questa edizione.
Aspose.Words FOSS per .NET include un piccolo insieme di classi modello per descrivere come più pagine di documento verrebbero disposte quando renderizzate in un unico output basato su immagine — MultiPageLayout e le sue enumerazioni di supporto. Questa edizione non include il motore di layout di pagina e di rendering stesso (see Caratteristiche e funzionalità e il riassunto del prodotto), quindi questi tipi esistono nella superficie pubblica di API come primitive di configurazione senza un percorso di salvataggio che li consumi in questa build.
MultiPageLayout
MultiPageLayout è una classe sigillata i cui metodi statici di fabbrica creano ciascuno una diversa disposizione multi-pagina: Vertical(verticalGap) impila le pagine dall’alto verso il basso con lo spazio specificato tra di esse; Horizontal(horizontalGap) posiziona le pagine una accanto all’altra, da sinistra a destra; Grid(columns, horizontalGap, verticalGap) dispone le pagine da sinistra a destra, dall’alto verso il basso in una griglia con il numero di colonne specificato; TiffFrames() mantiene ogni pagina come un frame separato anziché combinarle in un’unica immagine; e SinglePage() rende solo una singola pagina. Una volta costruita, un’istanza di MultiPageLayout espone BackColor e BorderColor (entrambi Color) e BorderWidth (float) per lo stile dell’output combinato.
Enumerazioni di Rendering Correlate
Tre enumerazioni aggiuntive descrivono lo stesso dominio “pagine di documento come immagini”: ImageColorMode (None, Grayscale, BlackAndWhite) controlla la modalità colore delle immagini di pagina generate; ImagePixelFormat elenca i formati pixel disponibili per le immagini di pagina generate (come Format24BppRgb e Format32BppArgb); e ImageBinarizationMethod (Threshold, FloydSteinbergDithering) specifica come un’immagine viene convertita in bianco e nero. Come per MultiPageLayout, questi sono definiti nella superficie API ma non sono attualmente collegati a una classe di opzioni di salvataggio in questa edizione — questa build FOSS non include l’esportazione di immagini, PDF o XPS.
Suggerimenti e migliori pratiche
- Tratta
MultiPageLayoute le sue enumerazioni correlate solo come riferimento in questa edizione — non esiste un percorsoSave()nella superficie pubblica API che consumi un’istanzaMultiPageLayoutper produrre effettivamente un’immagine. - Se il tuo flusso di lavoro necessita di rendere documenti Word in TIFF, PNG, JPEG o altri formati immagine, utilizza la versione commerciale Aspose.Words per .NET, che include il motore di rendering completo per cui questi tipi sono progettati.
- Non confondere quest’area di layout di pagina per immagini con l’incorporamento di immagini all’interno di un documento (il
Shape/ImageDataAPI) — è una funzionalità separata e normale del contenuto del documento, non il rendering della pagina.
Problemi comuni
| Problema | Causa | Correzione |
|---|---|---|
Nessun metodo accetta un’istanza MultiPageLayout | Questa edizione non include il motore di rendering image/PDF/XPS | Utilizza il Aspose.Words commerciale per .NET per il rendering delle pagine e l’esportazione delle immagini |
Document.Save() a un’estensione immagine fallisce | Questa edizione esclude il motore di rendering image/PDF/XPS richiesto dai formati di salvataggio basati su immagine | Salva in DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown o testo semplice invece |
FAQ
Posso usare MultiPageLayout per esportare il mio documento come TIFF multi-pagina?
Non in questa edizione. MultiPageLayout e le sue enumerazioni di supporto (ImageColorMode, ImagePixelFormat, ImageBinarizationMethod) sono presenti nella superficie API, ma la pipeline di salvataggio di rendering delle immagini che le consumerebbe non fa parte di questa build FOSS.
Perché esiste questa classe se non è funzionale qui?
Aspose.Words FOSS per .NET è il vero codice base Aspose.Words ridotto a un core gratuito, non una riscrittura — alcune classi del livello modello collegate al motore di rendering rimosso rimangono compilate nella libreria anche se nessun percorso di salvataggio supportato le utilizza attualmente.
L’incorporamento di un’immagine all’interno di un documento è anch’esso escluso?
No — inserire e formattare immagini all’interno del contenuto di un documento (tramite Shape e ImageData) è una funzionalità normale e supportata di modifica dei documenti. Solo il rendering di pagine intere in un formato immagine è escluso.
API Reference Riepilogo
| Classe / Enum | Descrizione |
|---|---|
MultiPageLayout | Configura come più pagine vengono combinate in un unico output basato su immagine (Vertical, Horizontal, Grid, TiffFrames, SinglePage) |
ImageColorMode | Modalità colore per le immagini delle pagine generate (None, Grayscale, BlackAndWhite) |
ImagePixelFormat | Opzioni di formato pixel per le immagini di pagina generate |
ImageBinarizationMethod | Metodo di conversione in bianco e nero (Threshold, FloydSteinbergDithering) |