Implement ListItem.setListSymbol

DEVSIX-443

Author: pavel-morozov-duallab

layout/src/main/java/com/itextpdf/layout/Property.java

@@ -47,7 +47,7 @@ public enum Property {
     LEFT,
     LINE_DRAWER,
     LIST_START,
-    LIST_SYMBOL,
+    LIST_SYMBOL(true),
     LIST_SYMBOL_INDENT,
     MARGIN_BOTTOM,
     MARGIN_LEFT,

layout/src/main/java/com/itextpdf/layout/element/ListItem.java

@@ -1,6 +1,7 @@
 package com.itextpdf.layout.element;
 
 import com.itextpdf.kernel.pdf.PdfName;
+import com.itextpdf.layout.Property;
 import com.itextpdf.layout.renderer.ListItemRenderer;
 
 /**
@@ -37,6 +38,46 @@ public ListItem(Image image) {
         add(image);
     }
 
+    /**
+     * Sets the list item symbol to be used.
+     * @param symbol the textual symbol to be used for the item.
+     * @return this list item.
+     */
+    public ListItem setListSymbol(String symbol) {
+        return setListSymbol(new Text(symbol));
+    }
+
+    /**
+     * Sets the list item symbol to be used.
+     * @param text the {@link Text} object to be used for the item.
+     * @return this list item.
+     */
+    public ListItem setListSymbol(Text text) {
+        return setProperty(Property.LIST_SYMBOL, text);
+    }
+
+    /**
+     * Sets the list item symbol to be used.
+     * @param image the {@link Image} object to be used for the item.
+     * @return this list.
+     */
+    public ListItem setListSymbol(Image image) {
+        return setProperty(Property.LIST_SYMBOL, image);
+    }
+
+    /**
+     * Sets the list item numbering type to be used.
+     * @param listNumberingType the {@link Property#ListNumberingType} that will generate appropriate prefixes for the {@link ListItem}.
+     * @return this list item.
+     */
+    public ListItem setListSymbol(Property.ListNumberingType listNumberingType) {
+        // Do not draw any points after ZapfDingbats special number symbol
+        if (listNumberingType == Property.ListNumberingType.ZAPF_DINGBATS_1 || listNumberingType == Property.ListNumberingType.ZAPF_DINGBATS_2 ||
+                listNumberingType == Property.ListNumberingType.ZAPF_DINGBATS_3 || listNumberingType == Property.ListNumberingType.ZAPF_DINGBATS_4) {
+        }
+        return setProperty(Property.LIST_SYMBOL, listNumberingType);
+    }
+
     @Override
     protected ListItemRenderer makeNewRenderer() {
         return new ListItemRenderer(this);

layout/src/main/java/com/itextpdf/layout/renderer/ListRenderer.java

@@ -31,7 +31,7 @@ public LayoutResult layout(LayoutContext layoutContext) {
         int listItemNum = getProperty(Property.LIST_START, 1);
         for (int i = 0; i < childRenderers.size(); i++) {
             if (childRenderers.get(i).getModelElement() instanceof ListItem) {
-                IRenderer currentSymbolRenderer = makeListSymbolRenderer(listItemNum++);
+                IRenderer currentSymbolRenderer = makeListSymbolRenderer(listItemNum++, childRenderers.get(i));
                 symbolRenderers.add(currentSymbolRenderer);
                 LayoutResult listSymbolLayoutResult = currentSymbolRenderer.layout(layoutContext);
                 if (listSymbolLayoutResult.getStatus() != LayoutResult.FULL) {
@@ -57,8 +57,8 @@ public LayoutResult layout(LayoutContext layoutContext) {
         return super.layout(layoutContext);
     }
 
-    protected IRenderer makeListSymbolRenderer(int index) {
-        Object defaultListSymbol = modelElement.getProperty(Property.LIST_SYMBOL);
+    protected IRenderer makeListSymbolRenderer(int index, IRenderer renderer) {
+        Object defaultListSymbol = renderer.getProperty(Property.LIST_SYMBOL);
         if (defaultListSymbol instanceof Text) {
             return new TextRenderer((Text) defaultListSymbol).setParent(this);
         } else if (defaultListSymbol instanceof Image) {