ChartMultilevelValue
Contents
[
Hide
]Inheritance: java.lang.Object
public class ChartMultilevelValue
Represents a value for charts that display multilevel data.
Examples:
Shows how to create treemap chart.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert a Treemap chart.
Shape shape = builder.insertChart(ChartType.TREEMAP, 450.0, 280.0);
Chart chart = shape.getChart();
chart.getTitle().setText("World Population");
// Delete default generated series.
chart.getSeries().clear();
// Add a series.
ChartSeries series = chart.getSeries().add(
"Population by Region",
new ChartMultilevelValue[]
{
new ChartMultilevelValue("Asia", "China"),
new ChartMultilevelValue("Asia", "India"),
new ChartMultilevelValue("Asia", "Indonesia"),
new ChartMultilevelValue("Asia", "Pakistan"),
new ChartMultilevelValue("Asia", "Bangladesh"),
new ChartMultilevelValue("Asia", "Japan"),
new ChartMultilevelValue("Asia", "Philippines"),
new ChartMultilevelValue("Asia", "Other"),
new ChartMultilevelValue("Africa", "Nigeria"),
new ChartMultilevelValue("Africa", "Ethiopia"),
new ChartMultilevelValue("Africa", "Egypt"),
new ChartMultilevelValue("Africa", "Other"),
new ChartMultilevelValue("Europe", "Russia"),
new ChartMultilevelValue("Europe", "Germany"),
new ChartMultilevelValue("Europe", "Other"),
new ChartMultilevelValue("Latin America", "Brazil"),
new ChartMultilevelValue("Latin America", "Mexico"),
new ChartMultilevelValue("Latin America", "Other"),
new ChartMultilevelValue("Northern America", "United States"),
new ChartMultilevelValue("Northern America", "Other"),
new ChartMultilevelValue("Oceania")
},
new double[]
{
1409670000.0, 1400744000.0, 279118866.0, 241499431.0, 169828911.0, 123930000.0, 112892781.0, 764000000.0,
223800000.0, 107334000.0, 105914499.0, 903000000.0,
146150789.0, 84607016.0, 516000000.0,
203080756.0, 129713690.0, 310000000.0,
335893238.0, 35000000.0,
42000000.0
});
// Show data labels.
series.hasDataLabels(true);
series.getDataLabels().setShowValue(true);
series.getDataLabels().setShowCategoryName(true);
DecimalFormatSymbols symbols = new DecimalFormatSymbols(Locale.getDefault());
String thousandSeparator = Character.toString(symbols.getGroupingSeparator());
series.getDataLabels().getNumberFormat().setFormatCode(String.format("#{0}0", thousandSeparator));
doc.save(getArtifactsDir() + "Charts.Treemap.docx");
Constructors
| Constructor | Description |
|---|---|
| ChartMultilevelValue(String level1, String level2, String level3) | Initializes a new instance of this class that represents a three-level value. |
| ChartMultilevelValue(String level1, String level2) | Initializes a new instance of this class that represents a two-level value. |
| ChartMultilevelValue(String level1) | Initializes a new instance of this class that represents a single-level value. |
Methods
| Method | Description |
|---|---|
| equals(Object obj) | Gets a flag indicating whether the specified object is equal to the current multilevel data object. |
| getLevel1() | Gets the name of the chart top level that this value refers to. |
| getLevel2() | Gets the name of the chart intermediate level that this value refers to. |
| getLevel3() | Gets the name of the chart bottom level that this value refers to. |
| hashCode() |
ChartMultilevelValue(String level1, String level2, String level3)
public ChartMultilevelValue(String level1, String level2, String level3)
Initializes a new instance of this class that represents a three-level value.
Examples:
Shows how to create treemap chart.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert a Treemap chart.
Shape shape = builder.insertChart(ChartType.TREEMAP, 450.0, 280.0);
Chart chart = shape.getChart();
chart.getTitle().setText("World Population");
// Delete default generated series.
chart.getSeries().clear();
// Add a series.
ChartSeries series = chart.getSeries().add(
"Population by Region",
new ChartMultilevelValue[]
{
new ChartMultilevelValue("Asia", "China"),
new ChartMultilevelValue("Asia", "India"),
new ChartMultilevelValue("Asia", "Indonesia"),
new ChartMultilevelValue("Asia", "Pakistan"),
new ChartMultilevelValue("Asia", "Bangladesh"),
new ChartMultilevelValue("Asia", "Japan"),
new ChartMultilevelValue("Asia", "Philippines"),
new ChartMultilevelValue("Asia", "Other"),
new ChartMultilevelValue("Africa", "Nigeria"),
new ChartMultilevelValue("Africa", "Ethiopia"),
new ChartMultilevelValue("Africa", "Egypt"),
new ChartMultilevelValue("Africa", "Other"),
new ChartMultilevelValue("Europe", "Russia"),
new ChartMultilevelValue("Europe", "Germany"),
new ChartMultilevelValue("Europe", "Other"),
new ChartMultilevelValue("Latin America", "Brazil"),
new ChartMultilevelValue("Latin America", "Mexico"),
new ChartMultilevelValue("Latin America", "Other"),
new ChartMultilevelValue("Northern America", "United States"),
new ChartMultilevelValue("Northern America", "Other"),
new ChartMultilevelValue("Oceania")
},
new double[]
{
1409670000.0, 1400744000.0, 279118866.0, 241499431.0, 169828911.0, 123930000.0, 112892781.0, 764000000.0,
223800000.0, 107334000.0, 105914499.0, 903000000.0,
146150789.0, 84607016.0, 516000000.0,
203080756.0, 129713690.0, 310000000.0,
335893238.0, 35000000.0,
42000000.0
});
// Show data labels.
series.hasDataLabels(true);
series.getDataLabels().setShowValue(true);
series.getDataLabels().setShowCategoryName(true);
DecimalFormatSymbols symbols = new DecimalFormatSymbols(Locale.getDefault());
String thousandSeparator = Character.toString(symbols.getGroupingSeparator());
series.getDataLabels().getNumberFormat().setFormatCode(String.format("#{0}0", thousandSeparator));
doc.save(getArtifactsDir() + "Charts.Treemap.docx");
Parameters:
| Parameter | Type | Description |
|---|---|---|
| level1 | java.lang.String | |
| level2 | java.lang.String | |
| level3 | java.lang.String |
ChartMultilevelValue(String level1, String level2)
public ChartMultilevelValue(String level1, String level2)
Initializes a new instance of this class that represents a two-level value.
Examples:
Shows how to create treemap chart.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert a Treemap chart.
Shape shape = builder.insertChart(ChartType.TREEMAP, 450.0, 280.0);
Chart chart = shape.getChart();
chart.getTitle().setText("World Population");
// Delete default generated series.
chart.getSeries().clear();
// Add a series.
ChartSeries series = chart.getSeries().add(
"Population by Region",
new ChartMultilevelValue[]
{
new ChartMultilevelValue("Asia", "China"),
new ChartMultilevelValue("Asia", "India"),
new ChartMultilevelValue("Asia", "Indonesia"),
new ChartMultilevelValue("Asia", "Pakistan"),
new ChartMultilevelValue("Asia", "Bangladesh"),
new ChartMultilevelValue("Asia", "Japan"),
new ChartMultilevelValue("Asia", "Philippines"),
new ChartMultilevelValue("Asia", "Other"),
new ChartMultilevelValue("Africa", "Nigeria"),
new ChartMultilevelValue("Africa", "Ethiopia"),
new ChartMultilevelValue("Africa", "Egypt"),
new ChartMultilevelValue("Africa", "Other"),
new ChartMultilevelValue("Europe", "Russia"),
new ChartMultilevelValue("Europe", "Germany"),
new ChartMultilevelValue("Europe", "Other"),
new ChartMultilevelValue("Latin America", "Brazil"),
new ChartMultilevelValue("Latin America", "Mexico"),
new ChartMultilevelValue("Latin America", "Other"),
new ChartMultilevelValue("Northern America", "United States"),
new ChartMultilevelValue("Northern America", "Other"),
new ChartMultilevelValue("Oceania")
},
new double[]
{
1409670000.0, 1400744000.0, 279118866.0, 241499431.0, 169828911.0, 123930000.0, 112892781.0, 764000000.0,
223800000.0, 107334000.0, 105914499.0, 903000000.0,
146150789.0, 84607016.0, 516000000.0,
203080756.0, 129713690.0, 310000000.0,
335893238.0, 35000000.0,
42000000.0
});
// Show data labels.
series.hasDataLabels(true);
series.getDataLabels().setShowValue(true);
series.getDataLabels().setShowCategoryName(true);
DecimalFormatSymbols symbols = new DecimalFormatSymbols(Locale.getDefault());
String thousandSeparator = Character.toString(symbols.getGroupingSeparator());
series.getDataLabels().getNumberFormat().setFormatCode(String.format("#{0}0", thousandSeparator));
doc.save(getArtifactsDir() + "Charts.Treemap.docx");
Parameters:
| Parameter | Type | Description |
|---|---|---|
| level1 | java.lang.String | |
| level2 | java.lang.String |
ChartMultilevelValue(String level1)
public ChartMultilevelValue(String level1)
Initializes a new instance of this class that represents a single-level value.
Examples:
Shows how to create treemap chart.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert a Treemap chart.
Shape shape = builder.insertChart(ChartType.TREEMAP, 450.0, 280.0);
Chart chart = shape.getChart();
chart.getTitle().setText("World Population");
// Delete default generated series.
chart.getSeries().clear();
// Add a series.
ChartSeries series = chart.getSeries().add(
"Population by Region",
new ChartMultilevelValue[]
{
new ChartMultilevelValue("Asia", "China"),
new ChartMultilevelValue("Asia", "India"),
new ChartMultilevelValue("Asia", "Indonesia"),
new ChartMultilevelValue("Asia", "Pakistan"),
new ChartMultilevelValue("Asia", "Bangladesh"),
new ChartMultilevelValue("Asia", "Japan"),
new ChartMultilevelValue("Asia", "Philippines"),
new ChartMultilevelValue("Asia", "Other"),
new ChartMultilevelValue("Africa", "Nigeria"),
new ChartMultilevelValue("Africa", "Ethiopia"),
new ChartMultilevelValue("Africa", "Egypt"),
new ChartMultilevelValue("Africa", "Other"),
new ChartMultilevelValue("Europe", "Russia"),
new ChartMultilevelValue("Europe", "Germany"),
new ChartMultilevelValue("Europe", "Other"),
new ChartMultilevelValue("Latin America", "Brazil"),
new ChartMultilevelValue("Latin America", "Mexico"),
new ChartMultilevelValue("Latin America", "Other"),
new ChartMultilevelValue("Northern America", "United States"),
new ChartMultilevelValue("Northern America", "Other"),
new ChartMultilevelValue("Oceania")
},
new double[]
{
1409670000.0, 1400744000.0, 279118866.0, 241499431.0, 169828911.0, 123930000.0, 112892781.0, 764000000.0,
223800000.0, 107334000.0, 105914499.0, 903000000.0,
146150789.0, 84607016.0, 516000000.0,
203080756.0, 129713690.0, 310000000.0,
335893238.0, 35000000.0,
42000000.0
});
// Show data labels.
series.hasDataLabels(true);
series.getDataLabels().setShowValue(true);
series.getDataLabels().setShowCategoryName(true);
DecimalFormatSymbols symbols = new DecimalFormatSymbols(Locale.getDefault());
String thousandSeparator = Character.toString(symbols.getGroupingSeparator());
series.getDataLabels().getNumberFormat().setFormatCode(String.format("#{0}0", thousandSeparator));
doc.save(getArtifactsDir() + "Charts.Treemap.docx");
Parameters:
| Parameter | Type | Description |
|---|---|---|
| level1 | java.lang.String |
equals(Object obj)
public boolean equals(Object obj)
Gets a flag indicating whether the specified object is equal to the current multilevel data object.
Parameters:
| Parameter | Type | Description |
|---|---|---|
| obj | java.lang.Object |
Returns: boolean
getLevel1()
public String getLevel1()
Gets the name of the chart top level that this value refers to.
Returns: java.lang.String - The name of the chart top level that this value refers to.
getLevel2()
public String getLevel2()
Gets the name of the chart intermediate level that this value refers to.
Returns: java.lang.String - The name of the chart intermediate level that this value refers to.
getLevel3()
public String getLevel3()
Gets the name of the chart bottom level that this value refers to.
Returns: java.lang.String - The name of the chart bottom level that this value refers to.
hashCode()
public int hashCode()
Returns: int