Lavorare con le immagini

Aspose.Words consente agli utenti di lavorare con le immagini in modo molto flessibile. In questo articolo puoi esplorare solo alcune delle possibilità di lavorare con le immagini.

Come inserire un’immagine

DocumentBuilder fornisce diversi sovraccarichi del metodo InsertImage che consentono di inserire un’immagine in linea o mobile. Se l’immagine è un metafile EMF o WMF, verrà inserita nel documento in formato metafile. Tutte le altre immagini verranno archiviate in formato PNG. Il metodo InsertImage può utilizzare immagini provenienti da diverse fonti:

• Da un file o URL passando un parametro String InsertImage
• Da uno stream passando un parametro Stream InsertImage
• Da un oggetto Immagine passando un parametro Immagine InsertImage
• Da un array di byte passando un parametro di array di byte InsertImage

Per ognuno dei metodi InsertImage sono presenti ulteriori sovraccarichi che permettono di inserire un’immagine con le seguenti opzioni:

• In linea o mobile in una posizione specifica, ad esempio InsertImage
• Scala percentuale o dimensione personalizzata, ad esempio InsertImage; inoltre il metodo InsertImage restituisce un oggetto Shape appena creato e inserito per poter modificare ulteriormente le proprietà della Shape

Come inserire un’immagine in linea

Passa una singola stringa che rappresenta un file che contiene l’immagine a InsertImage per inserire l’immagine nel documento come elemento grafico in linea

L’esempio di codice seguente mostra come inserire un’immagine in linea nella posizione del cursore in un documento:

Come inserire un’immagine mobile

L’esempio di codice seguente mostra come inserire un’immagine mobile da un file o URL in una posizione e dimensione specificate:

Come estrarre immagini da un documento

Tutte le immagini sono archiviate all’interno dei nodi Shape in un Document. Per estrarre tutte le immagini o le immagini di tipo specifico dal documento, attenersi alla seguente procedura:

• Utilizzare il metodo GetChildNodes per selezionare tutti i nodi Shape.
• Iterare attraverso le raccolte di nodi risultanti.
• Controlla la proprietà booleana HasImage.
• Estrai i dati dell’immagine utilizzando la proprietà ImageData.
• Salvare i dati dell’immagine in un file.

Il seguente esempio di codice mostra come estrarre immagini da un documento e salvarle come file:

È possibile scaricare il file di esempio di questo esempio da Aspose.Words GitHub.

Come inserire il codice a barre su ciascuna pagina del documento

Questo esempio dimostra come aggiungere codici a barre uguali o diversi su tutte o su pagine specifiche di un documento Word. Non esiste un modo diretto per aggiungere codici a barre su tutte le pagine di un documento ma puoi utilizzare i metodi MoveToSection, MoveToHeaderFooter e InsertImage per spostarti in qualsiasi sezione o intestazione/piè di pagina e inserire le immagini del codice a barre come puoi vedere nel codice seguente.

Il seguente esempio di codice mostra come inserire un’immagine del codice a barre su ogni pagina di un documento:

Blocca le proporzioni dell’immagine

Le proporzioni di una forma geometrica sono il rapporto tra le sue dimensioni in diverse dimensioni. È possibile bloccare le proporzioni dell’immagine utilizzando AspectRatioLocked. Il valore predefinito delle proporzioni della forma dipende dal ShapeType. È true per ShapeType.Image e false per altri tipi di forma.

Il seguente esempio di codice mostra come lavorare con le proporzioni:

Come ottenere i limiti effettivi della forma nei punti

Se desideri che il riquadro di delimitazione effettivo della forma venga visualizzato sulla pagina, puoi ottenerlo utilizzando la proprietà BoundsInPoints.

L’esempio di codice seguente mostra come utilizzare questa proprietà:

Ritaglia immagini

Il ritaglio di un’immagine si riferisce solitamente alla rimozione delle parti esterne indesiderate di un’immagine per migliorare l’inquadratura. Viene utilizzato anche per rimuovere alcune porzioni di un’immagine per aumentare la messa a fuoco su un’area particolare.

L’esempio di codice seguente mostra come ottenere questo risultato utilizzando Aspose.Words API:

Salva le immagini come WMF

Aspose.Words fornisce funzionalità per salvare tutte le immagini disponibili in un documento in formato WMF durante la conversione di DOCX in RTF.

Il seguente esempio di codice mostra come salvare le immagini come WMF con le opzioni di salvataggio RTF: