# Converti presentazioni PowerPoint in modalità Handout usando Java

> Converti le presentazioni in handout in Java. Imposta le diapositive per pagina, mantieni le note, esporta in PDF o immagini con Aspose.Slides, con esempio di codice Java. Provalo gratuitamente.

Source: https://docs.aspose.com/slides/it/java/convert-powerpoint-in-handout-mode/
Updated: 2026-06-12

## **Introduzione**

Aspose.Slides consente di convertire le presentazioni in formati di output che supportano la modalità Handout. In questa modalità, più diapositive vengono disposte su una singola pagina, il che è utile per stampare i materiali delle presentazioni per conferenze, seminari e eventi simili.

La modalità Handout è configurata tramite il metodo `setSlidesLayoutOptions`, disponibile in [IPdfOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/ipdfoptions/), [IRenderingOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/irenderingoptions/), [IHtmlOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/ihtmloptions/) e [ITiffOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/itiffoptions/). Per definire il layout del handout, utilizzare l'oggetto [HandoutLayoutingOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/handoutlayoutingoptions/).

## **Esportazione in modalità Handout**

Per esportare una presentazione in modalità Handout, impostare il metodo `setSlidesLayoutOptions` per le opzioni di esportazione di destinazione e assegnare un'istanza di [HandoutLayoutingOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/handoutlayoutingoptions/) che definisce il numero di diapositive per pagina e i relativi parametri di visualizzazione.

Di seguito è riportato un esempio di codice che mostra come convertire una presentazione in PDF in modalità Handout.

```java
// Carica una presentazione.
Presentation presentation = new Presentation("sample.pptx");
try {
    // Imposta le opzioni di esportazione.
    HandoutLayoutingOptions slidesLayoutOptions = new HandoutLayoutingOptions();
    slidesLayoutOptions.setHandout(HandoutType.Handouts4Horizontal);  // 4 diapositive su una pagina orizzontalmente
    slidesLayoutOptions.setPrintSlideNumbers(true);                   // stampa i numeri delle diapositive
    slidesLayoutOptions.setPrintFrameSlide(true);                     // stampa un riquadro attorno alle diapositive
    slidesLayoutOptions.setPrintComments(false);                      // nessun commento

    PdfOptions pdfOptions = new PdfOptions();
    pdfOptions.setSlidesLayoutOptions(slidesLayoutOptions);

    // Esporta la presentazione in PDF con il layout scelto.
    presentation.save("output.pdf", SaveFormat.Pdf, pdfOptions);
} finally {
    if (presentation != null) presentation.dispose();    
}
```

{{% alert color="warning" %}} 
Tenere presente che il metodo `setSlidesLayoutOptions` è disponibile solo per alcuni formati di output, come PDF, HTML, TIFF, e durante il rendering come immagini.
{{% /alert %}} 

## **FAQ**

**Qual è il numero massimo di miniatura di diapositive per pagina in modalità Handout?**

Aspose.Slides supporta i [preset](https://reference.aspose.com/slides/it/java/com.aspose.slides/handouttype/) fino a 9 miniature per pagina con ordinamento orizzontale o verticale: 1, 2, 3, 4 (orizzontale/verticale), 6 (orizzontale/verticale) e 9 (orizzontale/verticale).

**Posso definire una griglia personalizzata, ad esempio 5 o 8 diapositive per pagina?**

No. Il numero e l'ordinamento delle miniature sono controllati rigorosamente dalla classe [HandoutType](https://reference.aspose.com/slides/it/java/com.aspose.slides/handouttype/); layout arbitrari non sono supportati.

**Posso includere le diapositive nascoste nell'output Handout?**

Sì. Abilitare le diapositive nascoste utilizzando il metodo `setShowHiddenSlides` nelle impostazioni di esportazione per il formato di destinazione, come [PdfOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/pdfoptions/), [HtmlOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmloptions/) o [TiffOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/tiffoptions/).