# Ottieni le proprietà efficaci della forma dalle presentazioni su Android > Scopri come Aspose.Slides per Android via Java calcola e applica le proprietà efficaci delle forme per una resa precisa di PowerPoint. Source: https://docs.aspose.com/slides/it/androidjava/shape-effective-properties/ Updated: 2026-06-12 ## **Panoramica** Questo argomento spiega la differenza tra le proprietà **locali** e **efficaci**. I valori locali sono valori impostati direttamente a un livello specifico di formattazione, come: 1. Proprietà della porzione su una diapositiva. 1. Stili di testo della forma prototipo su un layout o diapositiva master, quando la forma del riquadro di testo della porzione ne ha uno. 1. Impostazioni di testo globali in una presentazione. I valori locali possono essere definiti o omessi a qualsiasi livello. Quando Aspose.Slides ha bisogno della formattazione finale “come resa”, risolve la catena di ereditarietà e restituisce i valori **efficaci**. È possibile ottenerli chiamando il metodo `getEffective()` sull'oggetto di formato locale. L'esempio seguente mostra come ottenere i valori efficaci. Assume che la prima forma sulla prima diapositiva sia un [IAutoShape](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/iautoshape/) con un riquadro di testo e almeno una porzione. ```java Presentation presentation = new Presentation("sample.pptx"); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape shape = (IAutoShape)slide.getShapes().get_Item(0); ITextFrame textFrame = shape.getTextFrame(); ITextFrameFormatEffectiveData effectiveTextFrameFormat = textFrame.getTextFrameFormat().getEffective(); IPortion portion = textFrame.getParagraphs().get_Item(0).getPortions().get_Item(0); IPortionFormatEffectiveData effectivePortionFormat = portion.getPortionFormat().getEffective(); } finally { presentation.dispose(); } ``` {{% alert color="primary" %}} I dati di formattazione efficaci rappresentano la formattazione calcolata corrente dopo l'applicazione dell'ereditarietà. Nell'implementazione attuale, alcuni oggetti di dati efficaci, come [IPortionFormatEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/iportionformateffectivedata/), possono essere memorizzati nella cache internamente. Richiamare nuovamente `getEffective()` dopo aver modificato la formattazione padre o ereditata può aggiornare i dati cache, e un oggetto ottenuto in precedenza potrebbe non rappresentare più lo stato precedente. Se è necessario conservare i valori efficaci per un riutilizzo successivo, copiare le proprietà richieste, come altezza del carattere, colore di riempimento, stile del carattere o allineamento, nel proprio oggetto dati. {{% /alert %}} ## **Ottenere le proprietà efficaci di una Camera** Aspose.Slides consente di ottenere le proprietà efficaci di una fotocamera. L'interfaccia [ICameraEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/icameraeffectivedata/) rappresenta un oggetto immutabile che contiene le proprietà efficaci della fotocamera. Un'istanza di [ICameraEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/icameraeffectivedata/) è esposta tramite [IThreeDFormatEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ithreedformateffectivedata/), che fornisce valori efficaci per [IThreeDFormat](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ithreedformat/). Il seguente esempio di codice mostra come ottenere le proprietà efficaci per la fotocamera. Assume che la prima forma sulla prima diapositiva abbia una formattazione 3D. ```java Presentation presentation = new Presentation("sample.pptx"); try { ISlide slide = presentation.getSlides().get_Item(0); IShape shape = slide.getShapes().get_Item(0); IThreeDFormatEffectiveData threeDEffectiveData = shape.getThreeDFormat().getEffective(); ICameraEffectiveData cameraEffectiveData = threeDEffectiveData.getCamera(); System.out.println("= Effective camera properties ="); System.out.println("Type: " + cameraEffectiveData.getCameraType()); System.out.println("Field of view: " + cameraEffectiveData.getFieldOfViewAngle()); System.out.println("Zoom: " + cameraEffectiveData.getZoom()); } finally { presentation.dispose(); } ``` ## **Ottenere le proprietà efficaci di un Light Rig** Aspose.Slides consente di ottenere le proprietà efficaci di un Light Rig. L'interfaccia [ILightRigEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ilightrigeffectivedata/) rappresenta un oggetto immutabile che contiene le proprietà efficaci del rig di illuminazione. Un'istanza di [ILightRigEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ilightrigeffectivedata/) è esposta tramite [IThreeDFormatEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ithreedformateffectivedata/), che fornisce valori efficaci per [IThreeDFormat](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ithreedformat/). Il seguente esempio di codice mostra come ottenere le proprietà efficaci per il rig di illuminazione. Assume che la prima forma sulla prima diapositiva abbia una formattazione 3D. ```java Presentation presentation = new Presentation("sample.pptx"); try { ISlide slide = presentation.getSlides().get_Item(0); IShape shape = slide.getShapes().get_Item(0); IThreeDFormatEffectiveData threeDEffectiveData = shape.getThreeDFormat().getEffective(); ILightRigEffectiveData lightRigEffectiveData = threeDEffectiveData.getLightRig(); System.out.println("= Effective light rig properties ="); System.out.println("Type: " + lightRigEffectiveData.getLightType()); System.out.println("Direction: " + lightRigEffectiveData.getDirection()); } finally { presentation.dispose(); } ``` ## **Ottenere le proprietà efficaci di una forma smussata** Aspose.Slides consente di ottenere le proprietà efficaci di una forma smussata. L'interfaccia [IShapeBevelEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ishapebeveleffectivedata/) rappresenta un oggetto immutabile che contiene le proprietà di rilievo delle facce per una forma. Un'istanza di [IShapeBevelEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ishapebeveleffectivedata/) è esposta tramite [IThreeDFormatEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ithreedformateffectivedata/), che fornisce valori efficaci per [IThreeDFormat](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ithreedformat/). Il seguente esempio di codice mostra come ottenere le proprietà efficaci per lo smusso superiore di una forma. Assume che la prima forma sulla prima diapositiva abbia una formattazione 3D. ```java Presentation presentation = new Presentation("sample.pptx"); try { ISlide slide = presentation.getSlides().get_Item(0); IShape shape = slide.getShapes().get_Item(0); IThreeDFormatEffectiveData threeDEffectiveData = shape.getThreeDFormat().getEffective(); IShapeBevelEffectiveData bevelTopEffectiveData = threeDEffectiveData.getBevelTop(); System.out.println("= Effective shape's top face relief properties ="); System.out.println("Type: " + bevelTopEffectiveData.getBevelType()); System.out.println("Width: " + bevelTopEffectiveData.getWidth()); System.out.println("Height: " + bevelTopEffectiveData.getHeight()); } finally { presentation.dispose(); } ``` ## **Ottenere le proprietà efficaci di un riquadro di testo** Utilizzando Aspose.Slides, è possibile ottenere le proprietà efficaci di un riquadro di testo. L'interfaccia [ITextFrameFormatEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/itextframeformateffectivedata/) contiene le proprietà di formattazione efficaci del riquadro di testo. Il seguente esempio di codice mostra come ottenere le proprietà di formattazione efficaci del riquadro di testo. Assume che la prima forma sulla prima diapositiva sia un [IAutoShape](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/iautoshape/) con un riquadro di testo. ```java Presentation presentation = new Presentation("sample.pptx"); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape shape = (IAutoShape)slide.getShapes().get_Item(0); ITextFrameFormatEffectiveData effectiveTextFrameFormat = shape.getTextFrame().getTextFrameFormat().getEffective(); System.out.println("Anchoring type: " + effectiveTextFrameFormat.getAnchoringType()); System.out.println("Autofit type: " + effectiveTextFrameFormat.getAutofitType()); System.out.println("Text vertical type: " + effectiveTextFrameFormat.getTextVerticalType()); System.out.println("Margins"); System.out.println(" Left: " + effectiveTextFrameFormat.getMarginLeft()); System.out.println(" Top: " + effectiveTextFrameFormat.getMarginTop()); System.out.println(" Right: " + effectiveTextFrameFormat.getMarginRight()); System.out.println(" Bottom: " + effectiveTextFrameFormat.getMarginBottom()); } finally { presentation.dispose(); } ``` ## **Ottenere le proprietà efficaci di uno stile di testo** Utilizzando Aspose.Slides, è possibile ottenere le proprietà efficaci di uno stile di testo. L'interfaccia [ITextStyleEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/itextstyleeffectivedata/) contiene le proprietà efficaci dello stile di testo. Il seguente esempio di codice mostra come ottenere le proprietà efficaci dello stile di testo. Assume che la prima forma sulla prima diapositiva sia un [IAutoShape](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/iautoshape/) con un riquadro di testo. ```java Presentation presentation = new Presentation("sample.pptx"); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape shape = (IAutoShape)slide.getShapes().get_Item(0); ITextStyleEffectiveData effectiveTextStyle = shape.getTextFrame().getTextFrameFormat().getTextStyle().getEffective(); int levelCount = 9; for (int levelIndex = 0; levelIndex < levelCount; levelIndex++) { IParagraphFormatEffectiveData effectiveStyleLevel = effectiveTextStyle.getLevel(levelIndex); System.out.println("= Effective paragraph formatting for style level #" + levelIndex + " ="); System.out.println("Depth: " + effectiveStyleLevel.getDepth()); System.out.println("Indent: " + effectiveStyleLevel.getIndent()); System.out.println("Alignment: " + effectiveStyleLevel.getAlignment()); System.out.println("Font alignment: " + effectiveStyleLevel.getFontAlignment()); } } finally { presentation.dispose(); } ``` ## **Ottenere il valore efficace dell'altezza del carattere** Utilizzando Aspose.Slides, è possibile ottenere l'altezza del carattere efficace. Il seguente codice dimostra come l'altezza del carattere efficace di una porzione cambia dopo che i valori locali dell'altezza del carattere sono impostati a diversi livelli della struttura della presentazione. ```java Presentation presentation = new Presentation(); try { ISlide slide = presentation.getSlides().get_Item(0); IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 75, false); autoShape.addTextFrame(""); IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0); paragraph.getPortions().clear(); IPortion firstPortion = new Portion("Sample text with first portion"); IPortion secondPortion = new Portion(" and second portion."); paragraph.getPortions().add(firstPortion); paragraph.getPortions().add(secondPortion); IPortionFormatEffectiveData firstPortionFormatEffectiveData = firstPortion.getPortionFormat().getEffective(); IPortionFormatEffectiveData secondPortionFormatEffectiveData = secondPortion.getPortionFormat().getEffective(); System.out.println("Effective font height just after creation:"); double firstPortionFontHeight = firstPortionFormatEffectiveData.getFontHeight(); double secondPortionFontHeight = secondPortionFormatEffectiveData.getFontHeight(); System.out.println("Portion #0: " + firstPortionFontHeight); System.out.println("Portion #1: " + secondPortionFontHeight); presentation.getDefaultTextStyle().getLevel(0).getDefaultPortionFormat().setFontHeight(24); firstPortionFormatEffectiveData = firstPortion.getPortionFormat().getEffective(); secondPortionFormatEffectiveData = secondPortion.getPortionFormat().getEffective(); System.out.println("Effective font height after setting the presentation default font height:"); firstPortionFontHeight = firstPortionFormatEffectiveData.getFontHeight(); secondPortionFontHeight = secondPortionFormatEffectiveData.getFontHeight(); System.out.println("Portion #0: " + firstPortionFontHeight); System.out.println("Portion #1: " + secondPortionFontHeight); paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(40); firstPortionFormatEffectiveData = firstPortion.getPortionFormat().getEffective(); secondPortionFormatEffectiveData = secondPortion.getPortionFormat().getEffective(); System.out.println("Effective font height after setting paragraph default font height:"); firstPortionFontHeight = firstPortionFormatEffectiveData.getFontHeight(); secondPortionFontHeight = secondPortionFormatEffectiveData.getFontHeight(); System.out.println("Portion #0: " + firstPortionFontHeight); System.out.println("Portion #1: " + secondPortionFontHeight); firstPortion.getPortionFormat().setFontHeight(55); firstPortionFormatEffectiveData = firstPortion.getPortionFormat().getEffective(); secondPortionFormatEffectiveData = secondPortion.getPortionFormat().getEffective(); System.out.println("Effective font height after setting portion #0 font height:"); firstPortionFontHeight = firstPortionFormatEffectiveData.getFontHeight(); secondPortionFontHeight = secondPortionFormatEffectiveData.getFontHeight(); System.out.println("Portion #0: " + firstPortionFontHeight); System.out.println("Portion #1: " + secondPortionFontHeight); secondPortion.getPortionFormat().setFontHeight(18); firstPortionFormatEffectiveData = firstPortion.getPortionFormat().getEffective(); secondPortionFormatEffectiveData = secondPortion.getPortionFormat().getEffective(); System.out.println("Effective font height after setting portion #1 font height:"); firstPortionFontHeight = firstPortionFormatEffectiveData.getFontHeight(); secondPortionFontHeight = secondPortionFormatEffectiveData.getFontHeight(); System.out.println("Portion #0: " + firstPortionFontHeight); System.out.println("Portion #1: " + secondPortionFontHeight); presentation.save("SetLocalFontHeightValues.pptx", SaveFormat.Pptx); } finally { presentation.dispose(); } ``` ## **Ottenere il formato di riempimento efficace per una tabella** Utilizzando Aspose.Slides, è possibile ottenere la formattazione di riempimento efficace per diverse parti della tabella. L'interfaccia [IFillFormatEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/ifillformateffectivedata/) contiene le proprietà di formattazione di riempimento efficaci. La formattazione delle celle ha priorità più alta rispetto alla formattazione delle righe, la formattazione delle righe ha priorità più alta rispetto alla formattazione delle colonne, e la formattazione delle colonne ha priorità più alta rispetto alla formattazione dell'intera tabella. Di conseguenza, le proprietà di [ICellFormatEffectiveData](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/icellformateffectivedata/) vengono utilizzate per disegnare la cella della tabella. Il seguente esempio di codice mostra come ottenere la formattazione di riempimento efficace per diverse parti della tabella. Assume che la prima forma sulla prima diapositiva sia un [ITable](https://reference.aspose.com/slides/it/androidjava/com.aspose.slides/itable/). ```java Presentation presentation = new Presentation("sample.pptx"); try { ISlide slide = presentation.getSlides().get_Item(0); ITable table = (ITable)slide.getShapes().get_Item(0); IRow row = table.getRows().get_Item(0); IColumn column = table.getColumns().get_Item(0); ICell cell = table.get_Item(0, 0); IFillFormatEffectiveData tableFillFormatEffective = table.getTableFormat().getEffective().getFillFormat(); IFillFormatEffectiveData rowFillFormatEffective = row.getRowFormat().getEffective().getFillFormat(); IFillFormatEffectiveData columnFillFormatEffective = column.getColumnFormat().getEffective().getFillFormat(); IFillFormatEffectiveData cellFillFormatEffective = cell.getCellFormat().getEffective().getFillFormat(); } finally { presentation.dispose(); } ``` ## **FAQ** **`getEffective()` restituisce uno snapshot?** Non sempre. I dati efficaci rappresentano la formattazione calcolata dopo l'applicazione dell'ereditarietà, ma alcuni oggetti di dati efficaci possono essere memorizzati nella cache internamente. Una chiamata successiva a `getEffective()` può ricalcolare la formattazione e aggiornare la cache, quindi un oggetto ottenuto in precedenza non dovrebbe essere considerato uno snapshot permanente. **Quando dovrei leggere nuovamente le proprietà efficaci?** Richiamare `getEffective()` di nuovo dopo aver modificato la formattazione locale, gli stili padre, la formattazione del layout, la formattazione master o le impostazioni predefinite a livello di presentazione. La chiamata successiva ricalcola la gerarchia di formattazione e restituisce il risultato efficace corrente. **La modifica o rimozione di una diapositiva layout/master influisce sulle proprietà efficaci già recuperate?** Sì, ma la modifica si riflette alla chiamata successiva di `getEffective()`. Se una sorgente di formattazione padre viene modificata o rimossa, i dati efficaci ottenuti in precedenza possono essere obsoleti. Una volta richiamato nuovamente `getEffective()`, Aspose.Slides ricalcola l'albero di formattazione e i caratteri, i colori, le dimensioni o altri valori risultanti possono cambiare. **Posso modificare i valori tramite gli oggetti di dati efficaci?** No. Gli oggetti di dati efficaci espongono i valori calcolati. Apporta le modifiche negli oggetti di formattazione locale, quindi ottieni nuovamente i valori efficaci. **Cosa succede se una proprietà non è impostata a livello di forma, né nel layout/master, né nelle impostazioni globali?** Il valore efficace è determinato dal meccanismo di default, che include le impostazioni predefinite di PowerPoint e Aspose.Slides. Tale valore risolto diventa parte dei dati efficaci correnti. **Dal valore efficace del carattere, posso capire a quale livello è stata fornita la dimensione o il tipo di carattere?** Non direttamente. I dati efficaci restituiscono il valore finale. Per scoprire la provenienza, controlla i valori locali nella porzione, nel paragrafo, nel riquadro di testo e negli stili di testo a livello di layout, master e presentazione per individuare dove appare la prima definizione esplicita. **Perché a volte i valori efficaci sembrano identici a quelli locali?** Perché il valore locale è risultato finale (non è stato necessario alcun livello di ereditarietà superiore). In questi casi, il valore efficace corrisponde al valore locale. **Quando dovrei usare le proprietà efficaci e quando dovrei lavorare solo con quelle locali?** Usa i dati efficaci quando hai bisogno del risultato “come reso” dopo l'applicazione di tutta l'ereditarietà, ad esempio per allineare colori, rientri o dimensioni. Se devi conservare quei valori indipendentemente da futuri cambiamenti di formattazione, copia le proprietà necessarie nel tuo oggetto. Se devi modificare la formattazione a un livello specifico, modifica le proprietà locali e, se necessario, leggi nuovamente i dati efficaci per verificare il risultato.