Android でのプレゼンテーションからシェイプの有効プロパティを取得

このトピックでは、有効プロパティとローカルプロパティについて説明します。これらのレベルで直接値を設定する場合

部分のスライド上の部分プロパティ;
レイアウトまたはマスタースライド上のプロトタイプシェイプテキストスタイル（部分のテキストフレームシェイプにある場合）;
プレゼンテーション全体のテキスト設定;

これらの値は ローカル 値と呼ばれます。任意のレベルで ローカル 値は定義されても、されなくてもかまいません。ただし、アプリケーションがその部分の表示を知る必要がある場合は有効値を使用します。getEffective() メソッドをローカル形式から呼び出すことで有効値を取得できます。

このサンプルコードは有効値の取得方法を示しています:

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IAutoShape shape = (IAutoShape)pres.getSlides().get_Item(0).getShapes().get_Item(0);

    ITextFrameFormat localTextFrameFormat = shape.getTextFrame().getTextFrameFormat();
    ITextFrameFormatEffectiveData effectiveTextFrameFormat = localTextFrameFormat.getEffective();

    IPortionFormat localPortionFormat = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat();
    IPortionFormatEffectiveData effectivePortionFormat = localPortionFormat.getEffective();
} finally {
    if (pres != null) pres.dispose();
}

カメラの有効プロパティを取得

Aspose.Slides for Android via Java は、開発者がカメラの有効プロパティを取得できるようにします。この目的のために、ICameraEffectiveData インターフェイスが Aspose.Slides に追加されました。ICameraEffectiveData インターフェイスは、カメラの有効プロパティを保持する不変オブジェクトを表します。ICameraEffectiveData インターフェイスのインスタンスは、IThreeDFormatEffectiveData インターフェイスの一部として使用され、これは ThreeDFormat クラスのeffective values ペアです。

このサンプルコードはカメラの有効プロパティの取得方法を示しています:

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IThreeDFormatEffectiveData threeDEffectiveData = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThreeDFormat().getEffective();

    System.out.println("= Effective camera properties =");
    System.out.println("Type: " + threeDEffectiveData.getCamera().getCameraType());
    System.out.println("Field of view: " + threeDEffectiveData.getCamera().getFieldOfViewAngle());
    System.out.println("Zoom: " + threeDEffectiveData.getCamera().getZoom());
} finally {
    if (pres != null) pres.dispose();
}

ライトリグの有効プロパティを取得

Aspose.Slides for Android via Java は、開発者がライトリグの有効プロパティを取得できるようにします。この目的のために、ILightRigEffectiveData インターフェイスが Aspose.Slides に追加されました。ILightRigEffectiveData インターフェイスは、ライトリグの有効プロパティを保持する不変オブジェクトを表します。ILightRigEffectiveData インターフェイスのインスタンスは、IThreeDFormatEffectiveData インターフェイスの一部として使用され、これは ThreeDFormat クラスのeffective values ペアです。

このサンプルコードはライトリグの有効プロパティの取得方法を示しています:

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IThreeDFormatEffectiveData threeDEffectiveData = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThreeDFormat().getEffective();

    System.out.println("= Effective light rig properties =");
    System.out.println("Type: " + threeDEffectiveData.getLightRig().getLightType());
    System.out.println("Direction: " + threeDEffectiveData.getLightRig().getDirection());
} finally {
    if (pres != null) pres.dispose();
}

ベベルシェイプの有効プロパティを取得

Aspose.Slides for Android via Java は、開発者がベベルシェイプの有効プロパティを取得できるようにします。この目的のために、IShapeBevelEffectiveData インターフェイスが Aspose.Slides に追加されました。IShapeBevelEffectiveData インターフェイスは、シェイプの面リリーフの有効プロパティを保持する不変オブジェクトを表します。IShapeBevelEffectiveData インターフェイスのインスタンスは、IThreeDFormatEffectiveData インターフェイスの一部として使用され、これは ThreeDFormat クラスのeffective values ペアです。

このサンプルコードはベベルシェイプの有効プロパティの取得方法を示しています:

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IThreeDFormatEffectiveData threeDEffectiveData = pres.getSlides().get_Item(0).getShapes().get_Item(0).getThreeDFormat().getEffective();

    System.out.println("= Effective shape's top face relief properties =");
    System.out.println("Type: " + threeDEffectiveData.getBevelTop().getBevelType());
    System.out.println("Width: " + threeDEffectiveData.getBevelTop().getWidth());
    System.out.println("Height: " + threeDEffectiveData.getBevelTop().getHeight());
} finally {
    if (pres != null) pres.dispose();
}

テキストフレームの有効プロパティを取得

Aspose.Slides for Android via Java を使用すると、テキストフレームの有効プロパティを取得できます。この目的のために、ITextFrameFormatEffectiveData インターフェイスが Aspose.Slides に追加されました。これにはテキストフレームの有効な書式設定プロパティが含まれます。

このサンプルコードはテキストフレームの有効書式設定プロパティの取得方法を示しています:

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IAutoShape shape = (IAutoShape)pres.getSlides().get_Item(0).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 {
    if (pres != null) pres.dispose();
}

テキストスタイルの有効プロパティを取得

Aspose.Slides for Android via Java を使用すると、テキストスタイルの有効プロパティを取得できます。この目的のために、ITextStyleEffectiveData インターフェイスが Aspose.Slides に追加されました。これには有効なテキストスタイルプロパティが含まれます。

このサンプルコードはテキストスタイルの有効プロパティの取得方法を示しています:

Presentation pres = new Presentation("Presentation1.pptx");
try {
    IAutoShape shape = (IAutoShape)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    ITextStyleEffectiveData effectiveTextStyle = shape.getTextFrame().getTextFrameFormat().getTextStyle().getEffective();

    for (int i = 0; i <= 8; i++)
    {
        IParagraphFormatEffectiveData effectiveStyleLevel = effectiveTextStyle.getLevel(i);
        System.out.println("= Effective paragraph formatting for style level #" + i + " =");

        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 {
    if (pres != null) pres.dispose();
}

有効なフォント高さの値を取得

Aspose.Slides for Android via Java を使用すると、フォント高さの有効プロパティを取得できます。ここでは、プレゼンテーションの異なる構造レベルでローカルフォント高さが設定された後に、部分の有効フォント高さの値が変化するコードを示しています:

Presentation pres = new Presentation();
try {
    IAutoShape newShape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 75, false);
    newShape.addTextFrame("");
    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().clear();

    IPortion portion0 = new Portion("Sample text with first portion");
    IPortion portion1 = new Portion(" and second portion.");

    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().add(portion0);
    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().add(portion1);

    System.out.println("Effective font height just after creation:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    pres.getDefaultTextStyle().getLevel(0).getDefaultPortionFormat().setFontHeight(24);
    System.out.println("Effective font height after setting entire presentation default font height:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().setFontHeight(40);
    System.out.println("Effective font height after setting paragraph default font height:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat().setFontHeight(55);
    System.out.println("Effective font height after setting portion #0 font height:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    newShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(1).getPortionFormat().setFontHeight(18);
    System.out.println("Effective font height after setting portion #1 font height:");
    System.out.println("Portion #0: " + portion0.getPortionFormat().getEffective().getFontHeight());
    System.out.println("Portion #1: " + portion1.getPortionFormat().getEffective().getFontHeight());

    pres.save("SetLocalFontHeightValues.pptx",SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

テーブルの有効な塗りつぶし書式を取得

Aspose.Slides for Android via Java を使用すると、テーブルのさまざまな論理部分の有効な塗りつぶし書式を取得できます。この目的のために、ICellFormatEffectiveData インターフェイスが Aspose.Slides に追加されました。これには有効な塗りつぶし書式プロパティが含まれます。注意点として、セル書式は常に行書式より優先され、行は列より優先され、列はテーブル全体より優先されます。

Presentation pres = new Presentation("Presentation1.pptx");
try {
    ITable tbl = (ITable)pres.getSlides().get_Item(0).getShapes().get_Item(0);
    ITableFormatEffectiveData tableFormatEffective = tbl.getTableFormat().getEffective();
    IRowFormatEffectiveData rowFormatEffective = tbl.getRows().get_Item(0).getRowFormat().getEffective();
    IColumnFormatEffectiveData columnFormatEffective = tbl.getColumns().get_Item(0).getColumnFormat().getEffective();
    ICellFormatEffectiveData cellFormatEffective = tbl.get_Item(0, 0).getCellFormat().getEffective();

    IFillFormatEffectiveData tableFillFormatEffective = tableFormatEffective.getFillFormat();
    IFillFormatEffectiveData rowFillFormatEffective = rowFormatEffective.getFillFormat();
    IFillFormatEffectiveData columnFillFormatEffective = columnFormatEffective.getFillFormat();
    IFillFormatEffectiveData cellFillFormatEffective = cellFormatEffective.getFillFormat();
} finally {
    if (pres != null) pres.dispose();
}

FAQ

「スナップショット」か「ライブオブジェクト」かを判断する方法、そして有効プロパティを再取得すべきタイミングは？

EffectiveData オブジェクトは呼び出し時点で計算された値の不変スナップショットです。シェイプのローカルまたは継承設定を変更した場合は、再度 EffectiveData を取得して更新された値を取得してください。

レイアウト/マスタースライドを変更すると、既に取得した有効プロパティは影響を受けますか？

はい、ただし再取得したときのみ反映されます。既に取得した EffectiveData オブジェクトは自動的に更新されません。レイアウトまたはマスターを変更した後に再度取得してください。

EffectiveData を通じて値を変更できますか？

できません。EffectiveData は読み取り専用です。ローカルの書式オブジェクト（シェイプ/テキスト/3D など）を変更し、その後必要に応じて EffectiveData を再取得してください。

シェイプレベル、レイアウト/マスター、全体設定のいずれにもプロパティが設定されていない場合はどうなりますか？

有効値はデフォルトの仕組み（PowerPoint/Aspose.Slides のデフォルト）によって決定されます。その解決された値が EffectiveData のスナップショットに含まれます。

有効なフォント値から、サイズやフォント名がどのレベルで設定されたか判断できますか？

直接はできません。EffectiveData は最終的な値のみを返します。ソースを特定するには、部分/段落/テキストフレームのローカル値やレイアウト/マスター/プレゼンテーションのテキストスタイルを確認し、最初に明示的に定義された場所を探してください。

なぜ EffectiveData の値がローカル値と同じに見えることがあるのですか？

ローカル値が最終的な値となり、上位レベルからの継承が不要だった場合です。そのような場合、EffectiveData の値はローカル値と一致します。

有効プロパティを使用すべきタイミングと、ローカルプロパティだけで作業すべきタイミングは？

すべての継承が適用された「実際に表示される」結果が必要なときは EffectiveData を使用します（例: 色、インデント、サイズの整合）。特定のレベルで書式を変更したい場合はローカルプロパティを変更し、必要に応じて EffectiveData を再取得して結果を確認してください。

Android でプレゼンテーションシェイプを管理する Android のプレゼンテーションにシェイプアニメーションを適用