Получение эффективных свойств фигур из презентаций на Android
Понимание локальных, унаследованных и эффективных свойств
Форматирование PowerPoint может исходить из нескольких источников. Значение, хранящееся непосредственно в объекте, является его локальным значением. Если это значение не задано, PowerPoint ищет источники форматирования у родительских объектов, такие как значение по умолчанию абзаца, стиль текста, макет или главный слайд, тема или параметры по умолчанию уровня презентации. Такие значения являются унаследованными значениями. Значение, которое остаётся после разрешения всей иерархии, называется эффективным значением — это значение, используемое для отрисовки объекта.
Например, часть текста может не определять собственную высоту шрифта. Её локальное значение getFontHeight тогда равно Float.NaN, что означает «не задано здесь». Часть может наследовать высоту от абзаца, стиля текста по умолчанию презентации или другого применимого источника. Вызов getEffective у формата части возвращает окончательно разрешённую высоту.
Используйте два типа данных форматирования для разных целей:
- Читайте или изменяйте локальный объект формата, например IPortionFormat, когда нужно контролировать, где определяется значение.
- Читайте объект эффективных данных, например IPortionFormatEffectiveData, когда нужен окончательный отрисованный результат. Эффективные данные доступны только для чтения.
Сравнение локальных, унаследованных и эффективных значений
В следующем полном примере создаётся фигура и задаются высоты шрифта на уровнях презентации, абзаца и части текста. Каждый шаг выводит значения, определённые на этих уровнях, и получаемое эффективное значение для одной и той же части текста. Пример также показывает, почему после изменения форматирования необходимо заново читать эффективные данные.
import com.aspose.slides.*;
public class Main {
public static void main(String[] args) {
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 500, 80, false);
ITextFrame textFrame = shape.addTextFrame("Effective formatting");
IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
IPortion portion = paragraph.getPortions().get_Item(0);
// Определить унаследованные значения на двух разных уровнях.
presentation.getDefaultTextStyle().getLevel(0).getDefaultPortionFormat().setFontHeight(20);
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(28);
printFontHeights("The portion inherits from the paragraph", presentation, paragraph, portion);
// Локальное значение в части переопределяет оба унаследованных значения.
portion.getPortionFormat().setFontHeight(36);
printFontHeights("A local value overrides inherited values", presentation, paragraph, portion);
// Изменение унаследованного значения не переопределяет существующее локальное значение.
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(30);
printFontHeights("The local value still has priority", presentation, paragraph, portion);
// Очистить локальное значение. Теперь часть снова наследует значение от абзаца.
portion.getPortionFormat().setFontHeight(Float.NaN);
printFontHeights("The local value is cleared", presentation, paragraph, portion);
// Очистить значение абзаца. Теперь результат поставляется значением по умолчанию презентации.
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(Float.NaN);
printFontHeights("The paragraph value is cleared", presentation, paragraph, portion);
presentation.save("effective-properties.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
}
private static void printFontHeights(String caption, Presentation presentation, IParagraph paragraph, IPortion portion) {
float presentationValue = presentation.getDefaultTextStyle().getLevel(0).getDefaultPortionFormat().getFontHeight();
float paragraphValue = paragraph.getParagraphFormat().getDefaultPortionFormat().getFontHeight();
float localValue = portion.getPortionFormat().getFontHeight();
// Прочитать эффективные данные после предыдущих изменений.
float effectiveValue = portion.getPortionFormat().getEffective().getFontHeight();
System.out.println(caption);
System.out.println(" Presentation default: " + formatLocalValue(presentationValue));
System.out.println(" Paragraph default: " + formatLocalValue(paragraphValue));
System.out.println(" Portion local: " + formatLocalValue(localValue));
System.out.println(" Portion effective: " + effectiveValue);
}
private static String formatLocalValue(float value) {
return Float.isNaN(value) ? "<not set>" : Float.toString(value);
}
}
Приоритет в этом примере таков: локальное форматирование части, затем форматирование абзаца, затем значение по умолчанию презентации. У других объектов могут быть другие цепочки наследования, но принцип тот же: более конкретное явно заданное значение выигрывает, а getEffective возвращает окончательный результат.
Получение эффективных свойств текста
Форматирование текста распределено между несколькими объектами:
- ITextFrameFormat.getEffective() разрешает свойства текстового кадра, такие как поля, привязка, автоматический размер и вертикальное направление текста.
- ITextStyle.getEffective() разрешает форматирование абзаца для каждого уровня текстового стиля.
- IParagraphFormat.getEffective() разрешает свойства абзаца, такие как выравнивание, отступы и маркеры.
- IPortionFormat.getEffective() разрешает свойства символов, такие как высота шрифта, гарнитура, цвет, полужирный и курсив.
Для следующего примера файл text-formatting.pptx должен содержать минимум один слайд и одну AutoShape с непустым текстовым кадром. AutoShape может находиться в любой позиции коллекции фигур; код ищет подходящий объект и проверяет его перед использованием.
import com.aspose.slides.*;
public class Main {
public static void main(String[] args) {
Presentation presentation = new Presentation("text-formatting.pptx");
try {
if (presentation.getSlides().size() == 0) {
throw new IllegalStateException("The presentation contains no slides.");
}
IAutoShape shape = findAutoShapeWithText(presentation.getSlides().get_Item(0));
if (shape == null) {
throw new IllegalStateException("The first slide must contain an AutoShape with non-empty text.");
}
ITextFrame textFrame = shape.getTextFrame();
IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
IPortion portion = paragraph.getPortions().get_Item(0);
ITextFrameFormatEffectiveData textFrameEffective = textFrame.getTextFrameFormat().getEffective();
IParagraphFormatEffectiveData paragraphEffective = paragraph.getParagraphFormat().getEffective();
IPortionFormatEffectiveData portionEffective = portion.getPortionFormat().getEffective();
System.out.println("Text frame margins:");
System.out.println(" Left: " + textFrameEffective.getMarginLeft());
System.out.println(" Top: " + textFrameEffective.getMarginTop());
System.out.println(" Right: " + textFrameEffective.getMarginRight());
System.out.println(" Bottom: " + textFrameEffective.getMarginBottom());
System.out.println("Paragraph alignment: " + paragraphEffective.getAlignment());
System.out.println("Font height: " + portionEffective.getFontHeight());
System.out.println("Bold: " + portionEffective.getFontBold());
ITextStyleEffectiveData effectiveTextStyle = textFrame.getTextFrameFormat().getTextStyle().getEffective();
for (int level = 0; level < 9; level++) {
IParagraphFormatEffectiveData levelEffective = effectiveTextStyle.getLevel(level);
System.out.println("Level " + level + " indent: " + levelEffective.getIndent());
}
} finally {
presentation.dispose();
}
}
private static IAutoShape findAutoShapeWithText(ISlide slide) {
for (IShape candidate : slide.getShapes()) {
if (candidate instanceof IAutoShape && hasNonEmptyText((IAutoShape)candidate)) {
return (IAutoShape)candidate;
}
}
return null;
}
private static boolean hasNonEmptyText(IAutoShape shape) {
if (shape.getTextFrame() == null) {
return false;
}
if (shape.getTextFrame().getParagraphs().getCount() == 0) {
return false;
}
return shape.getTextFrame().getParagraphs().get_Item(0).getPortions().getCount() > 0;
}
}
Получение эффективных 3D‑свойств
IThreeDFormat.getEffective() возвращает один объект IThreeDFormatEffectiveData, группирующий все разрешённые 3D‑настройки. Его методы getCamera, getLightRig, getBevelTop и getBevelBottom раскрывают соответствующие эффективные данные. Совместное чтение этих связанных настроек упрощает понимание окончательного 3D‑вида фигуры.
Для этого примера файл shape-3d.pptx должен содержать минимум одну фигуру на первом слайде. Примените к этой фигуре 3D‑камеру, освещение или настройки фаски, если хотите, чтобы вывод включал значения, отличные от значений по умолчанию.
import com.aspose.slides.*;
public class Main {
public static void main(String[] args) {
Presentation presentation = new Presentation("shape-3d.pptx");
try {
if (presentation.getSlides().size() == 0 || presentation.getSlides().get_Item(0).getShapes().size() == 0) {
throw new IllegalStateException("The first slide must contain a shape.");
}
IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);
IThreeDFormatEffectiveData threeDEffective = shape.getThreeDFormat().getEffective();
System.out.println("Camera:");
System.out.println(" Type: " + threeDEffective.getCamera().getCameraType());
System.out.println(" Field of view: " + threeDEffective.getCamera().getFieldOfViewAngle());
System.out.println(" Zoom: " + threeDEffective.getCamera().getZoom());
System.out.println("Light rig:");
System.out.println(" Type: " + threeDEffective.getLightRig().getLightType());
System.out.println(" Direction: " + threeDEffective.getLightRig().getDirection());
System.out.println("Top bevel:");
System.out.println(" Type: " + threeDEffective.getBevelTop().getBevelType());
System.out.println(" Width: " + threeDEffective.getBevelTop().getWidth());
System.out.println(" Height: " + threeDEffective.getBevelTop().getHeight());
} finally {
presentation.dispose();
}
}
}
Получение эффективного форматирования таблиц
Форматирование таблицы может задаваться как стилем таблицы, так и параметрами, применёнными ко всей таблице, столбцу, строке или отдельной ячейке. При конфликте явно заданных заливок приоритет следующий: ячейка, строка, столбец, затем вся таблица. Эффективный формат ячейки — это окончательный формат, используемый для её отрисовки.
Для этого примера файл table-formatting.pptx должен содержать минимум одну таблицу на первом слайде. Таблица должна иметь хотя бы одну строку и один столбец. Код ищет объект ITable вместо предположения, что getShapes().get_Item(0) является таблицей.
import com.aspose.slides.*;
public class Main {
public static void main(String[] args) {
Presentation presentation = new Presentation("table-formatting.pptx");
try {
if (presentation.getSlides().size() == 0) {
throw new IllegalStateException("The presentation contains no slides.");
}
ITable table = findTable(presentation.getSlides().get_Item(0));
if (table == null) {
throw new IllegalStateException("The first slide must contain a table.");
}
if (table.getRows().size() == 0 || table.getColumns().size() == 0) {
throw new IllegalStateException("The table must contain at least one cell.");
}
ITableFormatEffectiveData tableEffective = table.getTableFormat().getEffective();
IRowFormatEffectiveData rowEffective = table.getRows().get_Item(0).getRowFormat().getEffective();
IColumnFormatEffectiveData columnEffective = table.getColumns().get_Item(0).getColumnFormat().getEffective();
ICellFormatEffectiveData cellEffective = table.get_Item(0, 0).getCellFormat().getEffective();
System.out.println("Table fill: " + tableEffective.getFillFormat().getFillType());
System.out.println("Row fill: " + rowEffective.getFillFormat().getFillType());
System.out.println("Column fill: " + columnEffective.getFillFormat().getFillType());
System.out.println("Final cell fill: " + cellEffective.getFillFormat().getFillType());
} finally {
presentation.dispose();
}
}
private static ITable findTable(ISlide slide) {
for (IShape shape : slide.getShapes()) {
if (shape instanceof ITable) {
return (ITable)shape;
}
}
return null;
}
}
Если нужен цвет, а не только тип заливки, сначала проверьте эффективный getFillType, а затем используйте метод, соответствующий этому типу, например getSolidFillColor для сплошной заливки.
Повторное чтение эффективных данных после изменений
Эффективные данные описывают иерархию форматирования в момент их разрешения. Вызовите getEffective ещё раз после изменения любого элемента, участвующего в этой иерархии, включая:
- локальное форматирование объекта;
- значения по умолчанию абзаца или текстового кадра;
- стиль таблицы, формат таблицы, столбца, строки или ячейки;
- форматирование макета или главного слайда;
- данные темы или значения по умолчанию уровня презентации;
- макет или главный слайд, назначенный слайду.
Не храните объект эффективных данных как постоянный снимок. Aspose.Slides может кэшировать некоторые эффективные данные внутренне, и последующий вызов getEffective может обновить их. Если нужно сравнить значения до и после изменения, скопируйте необходимые скалярные значения — например высоту шрифта, цвет, выравнивание или ширину фаски — в свои переменные перед внесением изменений.
Чтобы изменить значение, обновите соответствующий локальный объект формата, а затем вызовите getEffective для проверки результата. Объекты эффективных данных сами по себе доступны только для чтения.
FAQ
Как определить, какой уровень предоставил эффективное значение?
Эффективные данные содержат только окончательное значение, а не его источник. Проверьте применимые локальные объекты, начиная с самого специфичного уровня и двигаясь наружу. Для текста это может быть часть, абзац, текстовый кадр, макет, главный слайд, тема и значения по умолчанию презентации. Неопределённые значения, такие как Float.NaN или null, означают, что поиск продолжается на следующем уровне.
Что происходит, если ни один уровень не задаёт свойство?
Aspose.Slides разрешает соответствующее значение по умолчанию PowerPoint или библиотеки. Это разрешённое значение появляется в эффективных данных, даже если ни один локальный объект явно его не задаёт.
Почему иногда эффективное значение совпадает с локальным?
Локальное значение выиграло в расчёте наследования. Это ожидаемо, когда свойство явно установлено в объекте и более специфическое правило его не переопределяет.
Когда следует использовать локальные данные вместо эффективных?
Используйте локальные данные для проверки или редактирования конкретного уровня форматирования. Используйте эффективные данные, когда вам нужен окончательный вид после учёта наследования, правил темы и применимых стилей. Полный пример сравнения демонстрирует оба подхода в одном рабочем процессе.