DataLabels clase

Encapsula una colección de todos los objetos DataLabel para la serie especificada.

Herencia: DataLabels → ChartTextFrame → ChartFrame

El tipo DataLabels expone los siguientes miembros:

Propiedades

Propiedad	Descripción
is_inner_mode	Indica si el tamaño del área de trazado incluye las marcas de graduación y las etiquetas de los ejes. Falso especifica que el tamaño determinará el tamaño del área del gráfico, las marcas de graduación y las etiquetas de los ejes.
border	Obtiene el `Line`.
area	Obtiene el `DataLabels.area`.
text_font	Obtiene un objeto `ChartFrame.font` del objeto ChartFrame especificado.
text_options	Obtiene y establece las opciones del texto.
font	Obtiene la fuente de DataLabels;
auto_scale_font	Verdadero si el texto del objeto cambia de tamaño de fuente al cambiar el tamaño del objeto. El valor predeterminado es Verdadero.
background_mode	Obtiene y establece el modo de visualización del fondo.
background	Obtiene y establece el modo de visualización del fondo.
is_automatic_size	Indica si el marco del gráfico tiene un tamaño automático.
x	Obtiene o establece la coordenada x de la esquina superior izquierda en unidades de 1/4000 del área del gráfico.
y	Obtiene o establece la coordenada y de la esquina superior izquierda en unidades de 1/4000 del área del gráfico.
height	Obtiene o establece la altura del marco en unidades de 1/4000 del área del gráfico.
width	Obtiene o establece el ancho del marco en unidades de 1/4000 del área del gráfico.
shadow	Verdadero si el marco tiene sombra.
shape_properties	Obtiene el objeto `ChartFrame.shape_properties`.
is_default_pos_be_set	Indica si las posiciones predeterminadas (DefaultX, DefaultY, DefaultWidth y DefaultHeight) están establecidas.
default_x	Representa x de la posición predeterminada en unidades de 1/4000 del área del gráfico.
default_y	Representa y de la posición predeterminada en unidades de 1/4000 del área del gráfico.
default_width	Representa el ancho de la posición predeterminada en unidades de 1/4000 del área del gráfico.
default_height	Representa la altura de la posición predeterminada en unidades de 1/4000 del área del gráfico.
default_x_ratio_to_chart	Representa x de la posición predeterminada en unidades de fracción del área del gráfico.
default_y_ratio_to_chart	Representa y de la posición predeterminada en unidades de fracción del área del gráfico.
default_width_ratio_to_chart	Representa el ancho de la posición predeterminada en unidades de fracción del área del gráfico.
default_height_ratio_to_chart	Representa la altura de la posición predeterminada en unidades de fracción del área del gráfico.
x_ratio_to_chart	Obtiene o establece la coordenada x de la esquina superior izquierda en unidades de relación del área del gráfico.
y_ratio_to_chart	Obtiene o establece la coordenada y de la esquina superior izquierda en unidades de relación del área del gráfico.
width_ratio_to_chart	Obtiene o establece el ancho del marco en unidades de proporción del área del gráfico.
height_ratio_to_chart	Obtiene o establece la altura del marco en unidades de proporción del área del gráfico.
x_pixel	Obtiene o establece la coordenada x de la esquina superior izquierda en unidades de píxeles.
y_pixel	Obtiene o establece la coordenada y de la esquina superior izquierda en unidades de píxeles.
width_pixel	Obtiene o establece el ancho del marco en unidades de píxeles.
height_pixel	Obtiene o establece la altura del marco en unidades de píxeles.
is_auto_text	Indica que el texto se genera automáticamente.
is_deleted	Indica si se eliminarán estas etiquetas de datos.
text_horizontal_alignment	Obtiene y establece la alineación horizontal del texto.
text_vertical_alignment	Obtiene o establece la alineación vertical del texto.
rotation_angle	Representa el ángulo de rotación del texto.
is_automatic_rotation	Indica si el texto del gráfico se gira automáticamente.
text	Obtiene o establece el texto de la etiqueta de datos.
linked_source	Obtiene y establece una referencia a la hoja de trabajo.
text_direction	Representa el orden de lectura del texto.
reading_order	Representa el orden de lectura del texto.
direction_type	Obtiene y establece la dirección del texto.
is_text_wrapped	Obtiene o establece un valor que indica si el texto está ajustado.
is_resize_shape_to_fit_text	Obtiene o establece si una forma debe ajustarse automáticamente para contener completamente el texto descrito en ella. El ajuste automático es cuando el texto dentro de una forma se escala para contener todo el texto dentro.
show_value	Representa el comportamiento de visualización de los valores de las etiquetas de datos de un gráfico específico. “Verdadero” muestra los valores. “Falso” para ocultarlos.
show_cell_range	Indica si se muestra el rango de celdas como etiquetas de datos.
show_percentage	Representa el comportamiento de visualización del valor porcentual de la etiqueta de datos de un gráfico específico. “Verdadero” muestra el valor porcentual. “Falso” para ocultarlo.
show_bubble_size	Representa el comportamiento de visualización del valor porcentual de la etiqueta de datos de un gráfico específico. “Verdadero” muestra el valor porcentual. “Falso” para ocultarlo.
show_category_name	Representa el comportamiento de visualización del nombre de la categoría de la etiqueta de datos de un gráfico específico. Verdadero para mostrar el nombre de la categoría de las etiquetas de datos en un gráfico. Falso para ocultarlo.
show_series_name	Indica si el nombre de la serie se muestra en las etiquetas de datos de un gráfico. Verdadero para mostrar el nombre de la serie. Falso para ocultarlo.
show_legend_key	Representa el comportamiento de visualización de la clave de leyenda de la etiqueta de datos de un gráfico especificado. Verdadero si la clave de leyenda de la etiqueta de datos está visible.
number_format	Representa la cadena de formato para el objeto DataLabels.
number	Obtiene y establece el formato de número incorporado.
number_format_linked	Verdadero si el formato del número está vinculado a las celdas (para que el formato del número cambie en las etiquetas cuando cambia en las celdas).
separator_type	Obtiene o establece el tipo de separador utilizado para las etiquetas de datos en un gráfico.
separator_value	Obtiene o establece el valor separador utilizado para las etiquetas de datos en un gráfico.
position	Representa la posición de la etiqueta de datos.
is_never_overlap	Indica si las etiquetas de datos nunca se superponen (para gráficos circulares).
shape_type	Obtiene o establece el tipo de forma de la etiqueta de datos.

Métodos

Método	Descripción
`set_position_auto(self)`	Establecer la posición del marco en automático
`characters(self, start_index, length)`	Devuelve un objeto Caracteres que representa un rango de caracteres dentro del texto.
`apply_font(self)`	Aplicar la fuente de las etiquetas de datos a todos los nodos secundarios.

Ejemplo

from aspose.cells import Workbook
from aspose.cells.charts import LabelPositionType

# Set the DataLabels in the chart
wb = Workbook("chart.xlsx")
chart = wb.worksheets[0].charts[0]
for i in range(len(chart.n_series)):
    datalabels = chart.n_series[i].data_labels
    # Set the position of DataLabels
    datalabels.position = LabelPositionType.INSIDE_BASE
    # Show the category name in the DataLabels
    datalabels.show_category_name = True
    # Show the value in the DataLabels
    datalabels.show_value = True
    # Not show the percentage in the DataLabels
    datalabels.show_percentage = False
    # Not show the legend key.
    datalabels.show_legend_key = False

Ver también

ChartTextFrame clase DisplayUnitLabel clase