DataLabelFormat

Inheritance: java.lang.Object, com.aspose.slides.PVIObject

All Implemented Interfaces: com.aspose.slides.IDataLabelFormat

public final class DataLabelFormat extends PVIObject implements IDataLabelFormat

Represents formatting options for DataLabel.

Methods

MethodDescription
getVersion()
isNumberFormatLinkedToSource()Read/write boolean.
setNumberFormatLinkedToSource(boolean value)Read/write boolean.
getNumberFormat()Represents the format string for the DataLabels object.
setNumberFormat(String value)Represents the format string for the DataLabels object.
getFormat()Represents the format of the data label.
getPosition()Represents the position of the data label.
setPosition(int value)Represents the position of the data label.
getShowLegendKey()Represents a specified chart’s data label legend key display behavior.
setShowLegendKey(boolean value)Represents a specified chart’s data label legend key display behavior.
getShowValue()Represents a specified chart’s data label percentage value display behavior.
setShowValue(boolean value)Represents a specified chart’s data label percentage value display behavior.
getShowCategoryName()Represents a specified chart’s data label category name display behavior.
setShowCategoryName(boolean value)Represents a specified chart’s data label category name display behavior.
getShowSeriesName()Returns or sets a Boolean to indicate the series name display behavior for the data labels on a chart.
setShowSeriesName(boolean value)Returns or sets a Boolean to indicate the series name display behavior for the data labels on a chart.
getShowPercentage()Represents a specified chart’s data label percentage value display behavior.
setShowPercentage(boolean value)Represents a specified chart’s data label percentage value display behavior.
getShowBubbleSize()Represents a specified chart’s data label bubble size value display behavior.
setShowBubbleSize(boolean value)Represents a specified chart’s data label bubble size value display behavior.
getShowLeaderLines()Represents a specified chart’s data label leader lines display behavior.
setShowLeaderLines(boolean value)Represents a specified chart’s data label leader lines display behavior.
getShowLabelValueFromCell()Represents a specified chart’s data label cell value display behavior.
setShowLabelValueFromCell(boolean value)Represents a specified chart’s data label cell value display behavior.
getShowLabelAsDataCallout()Determines either specified chart’s data label will be displayed as data callout or as data label.
setShowLabelAsDataCallout(boolean value)Determines either specified chart’s data label will be displayed as data callout or as data label.
getSeparator()Sets or returns a Variant representing the separator used for the data labels on a chart.
setSeparator(String value)Sets or returns a Variant representing the separator used for the data labels on a chart.
getTextFormat()Returns chart text format.
getChart()Returns the chart.

getVersion()

public long getVersion()

Version. Read-only long.

Returns: long

isNumberFormatLinkedToSource()

public final boolean isNumberFormatLinkedToSource()

Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the IsNumberFormatLinkedToSource property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the IsNumberFormatLinkedToSource property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().isNumberFormatLinkedToSource(val);” cause to all DataLabels.get_Item(i).isNumberFormatLinkedToSource() is equal to val).

Returns: boolean

setNumberFormatLinkedToSource(boolean value)

public final void setNumberFormatLinkedToSource(boolean value)

Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the IsNumberFormatLinkedToSource property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the IsNumberFormatLinkedToSource property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().isNumberFormatLinkedToSource(val);” cause to all DataLabels.get_Item(i).isNumberFormatLinkedToSource() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getNumberFormat()

public final String getNumberFormat()

Represents the format string for the DataLabels object. Read/write String.


series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
 series.getLabels().getDefaultDataLabelFormat().setNumberFormatLinkedToSource(false);
 series.getLabels().getDefaultDataLabelFormat().setNumberFormat("0.0%");

If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels, then this property gets or sets the default value of the NumberFormat property for the new data labels in the DataLabelCollection collection. When this property is set with a value, that value is also set for the NumberFormat property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setNumberFormat(val);” causes all DataLabels.get_Item(i).getNumberFormat() to equal to val).

Returns: java.lang.String

setNumberFormat(String value)

public final void setNumberFormat(String value)

Represents the format string for the DataLabels object. Read/write String.


series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
 series.getLabels().getDefaultDataLabelFormat().setNumberFormatLinkedToSource(false);
 series.getLabels().getDefaultDataLabelFormat().setNumberFormat("0.0%");

If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels, then this property gets or sets the default value of the NumberFormat property for the new data labels in the DataLabelCollection collection. When this property is set with a value, that value is also set for the NumberFormat property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setNumberFormat(val);” causes all DataLabels.get_Item(i).getNumberFormat() to equal to val).

Parameters:

ParameterTypeDescription
valuejava.lang.String

getFormat()

public final IFormat getFormat()

Represents the format of the data label. Read-only IFormat.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property represents the default format for the new data labels in the DataLabelCollection collection.

Returns: IFormat

getPosition()

public final int getPosition()

Represents the position of the data label. Read/write LegendDataLabelPosition.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the Position property for the new data labels in the DataLabelCollection collection. Represents the position for the DataLabel objects. Set this property with value also sets this value to the Position property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setPosition(val);” cause to all DataLabels.get_Item(i).getPosition() is equal to val).

Returns: int

setPosition(int value)

public final void setPosition(int value)

Represents the position of the data label. Read/write LegendDataLabelPosition.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the Position property for the new data labels in the DataLabelCollection collection. Represents the position for the DataLabel objects. Set this property with value also sets this value to the Position property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setPosition(val);” cause to all DataLabels.get_Item(i).getPosition() is equal to val).

Parameters:

ParameterTypeDescription
valueint

getShowLegendKey()

public final boolean getShowLegendKey()

Represents a specified chart’s data label legend key display behavior. True if the data label legend key is visible. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowLegendKey property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowLegendKey property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowLegendKey(val);” cause to all DataLabels.get_Item(i).getShowLegendKey() is equal to val).

Returns: boolean

setShowLegendKey(boolean value)

public final void setShowLegendKey(boolean value)

Represents a specified chart’s data label legend key display behavior. True if the data label legend key is visible. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowLegendKey property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowLegendKey property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowLegendKey(val);” cause to all DataLabels.get_Item(i).getShowLegendKey() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getShowValue()

public final boolean getShowValue()

Represents a specified chart’s data label percentage value display behavior. True displays the percentage value. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowValue property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowValue property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowValue(val);” cause to all DataLabels.get_Item(i).getShowValue() is equal to val).

Returns: boolean

setShowValue(boolean value)

public final void setShowValue(boolean value)

Represents a specified chart’s data label percentage value display behavior. True displays the percentage value. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowValue property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowValue property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowValue(val);” cause to all DataLabels.get_Item(i).getShowValue() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getShowCategoryName()

public final boolean getShowCategoryName()

Represents a specified chart’s data label category name display behavior. True to display the category name for the data labels on a chart. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowCategoryName property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowCategoryName property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowCategoryName(val);” cause to all DataLabels.get_Item(i).getShowCategoryName() is equal to val).

Returns: boolean

setShowCategoryName(boolean value)

public final void setShowCategoryName(boolean value)

Represents a specified chart’s data label category name display behavior. True to display the category name for the data labels on a chart. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowCategoryName property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowCategoryName property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowCategoryName(val);” cause to all DataLabels.get_Item(i).getShowCategoryName() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getShowSeriesName()

public final boolean getShowSeriesName()

Returns or sets a Boolean to indicate the series name display behavior for the data labels on a chart. True to show the series name. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowSeriesName property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowSeriesName property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowSeriesName(val);” cause to all DataLabels.get_Item(i).getShowSeriesName() is equal to val).

Returns: boolean

setShowSeriesName(boolean value)

public final void setShowSeriesName(boolean value)

Returns or sets a Boolean to indicate the series name display behavior for the data labels on a chart. True to show the series name. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowSeriesName property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowSeriesName property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowSeriesName(val);” cause to all DataLabels.get_Item(i).getShowSeriesName() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getShowPercentage()

public final boolean getShowPercentage()

Represents a specified chart’s data label percentage value display behavior. True displays the percentage value. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowPercentage property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowPercentage property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowPercentage(val);” cause to all DataLabels.get_Item(i).getShowPercentage() is equal to val).

Returns: boolean

setShowPercentage(boolean value)

public final void setShowPercentage(boolean value)

Represents a specified chart’s data label percentage value display behavior. True displays the percentage value. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowPercentage property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowPercentage property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowPercentage(val);” cause to all DataLabels.get_Item(i).getShowPercentage() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getShowBubbleSize()

public final boolean getShowBubbleSize()

Represents a specified chart’s data label bubble size value display behavior. True displays the bubble size value. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowBubbleSize property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowBubbleSize property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowBubbleSize(val);” cause to all DataLabels.get_Item(i).getShowBubbleSize() is equal to val).

Returns: boolean

setShowBubbleSize(boolean value)

public final void setShowBubbleSize(boolean value)

Represents a specified chart’s data label bubble size value display behavior. True displays the bubble size value. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowBubbleSize property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowBubbleSize property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowBubbleSize(val);” cause to all DataLabels.get_Item(i).getShowBubbleSize() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getShowLeaderLines()

public final boolean getShowLeaderLines()

Represents a specified chart’s data label leader lines display behavior. True displays the leader lines. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowLeaderLines property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowLeaderLines property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowLeaderLines(val);” cause to all DataLabels.get_Item(i).getShowLeaderLines() is equal to val).

Returns: boolean

setShowLeaderLines(boolean value)

public final void setShowLeaderLines(boolean value)

Represents a specified chart’s data label leader lines display behavior. True displays the leader lines. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowLeaderLines property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowLeaderLines property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowLeaderLines(val);” cause to all DataLabels.get_Item(i).getShowLeaderLines() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getShowLabelValueFromCell()

public final boolean getShowLabelValueFromCell()

Represents a specified chart’s data label cell value display behavior. True displays cell value. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowLabelValueFromCell property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowLabelValueFromCell property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowLabelValueFromCell(val);” cause to all DataLabels.get_Item(i).getShowLabelValueFromCell() is equal to val).

Returns: boolean

setShowLabelValueFromCell(boolean value)

public final void setShowLabelValueFromCell(boolean value)

Represents a specified chart’s data label cell value display behavior. True displays cell value. False to hide. Read/write boolean.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowLabelValueFromCell property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowLabelValueFromCell property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowLabelValueFromCell(val);” cause to all DataLabels.get_Item(i).getShowLabelValueFromCell() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getShowLabelAsDataCallout()

public final boolean getShowLabelAsDataCallout()

Determines either specified chart’s data label will be displayed as data callout or as data label.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowLabelAsDataCallout property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowLabelAsDataCallout property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowLabelAsDataCallout(val);” cause to all DataLabels.get_Item(i).getShowLabelAsDataCallout() is equal to val).

Returns: boolean

setShowLabelAsDataCallout(boolean value)

public final void setShowLabelAsDataCallout(boolean value)

Determines either specified chart’s data label will be displayed as data callout or as data label.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the ShowLabelAsDataCallout property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the ShowLabelAsDataCallout property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setShowLabelAsDataCallout(val);” cause to all DataLabels.get_Item(i).getShowLabelAsDataCallout() is equal to val).

Parameters:

ParameterTypeDescription
valueboolean

getSeparator()

public final String getSeparator()

Sets or returns a Variant representing the separator used for the data labels on a chart. Read/write String.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the Separator property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the Separator property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setSeparator(val);” cause to all DataLabels.get_Item(i).getSeparator() is equal to val).

Returns: java.lang.String

setSeparator(String value)

public final void setSeparator(String value)

Sets or returns a Variant representing the separator used for the data labels on a chart. Read/write String.


If parent of this DataLabelFormat object is a DataLabelCollection collection of data labels then this property gets or sets the default value of the Separator property for the new data labels in the DataLabelCollection collection. Set this property with value also sets this value to the Separator property for all data labels in the DataLabelCollection collection (i.e. “DataLabels.getDefaultDataLabelFormat().setSeparator(val);” cause to all DataLabels.get_Item(i).getSeparator() is equal to val).

Parameters:

ParameterTypeDescription
valuejava.lang.String

getTextFormat()

public final IChartTextFormat getTextFormat()

Returns chart text format. Read-only IChartTextFormat.

Returns: IChartTextFormat

getChart()

public final IChart getChart()

Returns the chart. Read-only IChart.

Returns: IChart