Gestire gli oggetti Ink della presentazione in Java

Introduzione

PowerPoint fornisce la funzione penna per consentirti di disegnare figure non standard, che possono essere utilizzate per evidenziare altri oggetti, mostrare connessioni e processi, e attirare l’attenzione su elementi specifici in una diapositiva.

Aspose.Slides fornisce tutti i tipi Ink (ad esempio la classe Ink) di cui hai bisogno per creare e gestire oggetti penna.

Differenze tra oggetti normali e oggetti Ink

Gli oggetti in una diapositiva PowerPoint sono tipicamente rappresentati da oggetti forma. Un oggetto forma, nella sua forma più semplice, è un contenitore che definisce l’area dell’oggetto stesso (il suo riquadro) insieme alle sue proprietà. Quest’ultimo include le dimensioni dell’area del contenitore, la forma del contenitore, lo sfondo del contenitore, ecc. Per ulteriori informazioni, vedere Shape Layout Format.

Tuttavia, quando PowerPoint tratta un oggetto Ink, ignora tutte le proprietà del riquadro dell’oggetto (contenitore) tranne le sue dimensioni. Le dimensioni dell’area del contenitore sono determinate dai valori standard width e height:

Tracce di Inkshape

Una traccia è un elemento di base o uno standard utilizzato per registrare la traiettoria di una penna mentre l’utente scrive inky digitale. Le tracce sono registrazioni che descrivono sequenze di punti collegati.

La forma più semplice di codifica specifica le coordinate X e Y di ogni punto di campionamento. Quando tutti i punti collegati vengono renderizzati, producono un’immagine come questa:

Proprietà del pennello per il disegno

Puoi usare un pennello per disegnare linee che collegano i punti degli elementi della traccia. Il pennello ha il proprio colore e dimensione, corrispondenti alle proprietà Brush.Color e Brush.Size.

Imposta il colore del pennello Ink

Questo codice Java mostra come impostare il colore per un pennello:

Presentation pres = new Presentation("pres.pptx");
try {
    IInk ink = (IInk)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    IInkTrace[] traces = ink.getTraces();
    IInkBrush brush = traces[0].getBrush();
    Color brushColor = brush.getColor();
    brush.setColor(Color.RED);
} finally {
    if (pres != null) pres.dispose();
}

Imposta la dimensione del pennello Ink

Questo codice Java mostra come impostare la dimensione per un pennello:

Presentation pres = new Presentation("pres.pptx");
try {
    IInk ink = (IInk)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    IInkTrace[] traces = ink.getTraces();
    IInkBrush brush = traces[0].getBrush();
    Dimension2D brushSize = brush.getSize();
    brush.setSize(new Dimension(5, 10));
} finally {
    if (pres != null) pres.dispose();
}

In generale, la larghezza e l’altezza di un pennello non corrispondono, quindi PowerPoint non visualizza la dimensione del pennello (la sezione dei dati è grigio). Ma quando la larghezza e l’altezza del pennello corrispondono, PowerPoint visualizza la sua dimensione in questo modo:

Per chiarezza, aumentiamo l’altezza dell’oggetto Ink e rivediamo le dimensioni importanti:

Il contenitore (riquadro) non considera la dimensione dei pennelli: assume sempre che lo spessore della linea sia zero (vedi l’ultima immagine).

Pertanto, per determinare l’area visibile dell’intero oggetto Ink, dobbiamo considerare la dimensione del pennello degli oggetti traccia. Qui, l’oggetto di destinazione (l’oggetto traccia del testo scritto a mano) è stato scalato alle dimensioni del contenitore (riquadro). Quando le dimensioni del contenitore (riquadro) cambiano, la dimensione del pennello rimane costante e viceversa.

PowerPoint mostra lo stesso comportamento quando tratta i testi:

Ulteriori approfondimenti

• Per leggere informazioni sulle forme in generale, consultare la sezione PowerPoint Shapes.
• Per ulteriori informazioni sui valori effettivi, vedere Shape Effective Properties.