Clase DataLabel (Excel VBA)

La clase DataLabel representa el rótulo de datos de una línea de tendencia o un punto del gráfico.

Los principales procedimientos de la clase DataLabel son Delete, Select, DataLabels.Delete y DataLabels.Select

Set

Para usar una variable de clase DataLabel, primero debe ser instanciado, por ejemplo

Dim dtl as DataLabel
Set dtl = ActiveCell.Width(1).DataLabel

Los siguientes procedimientos se pueden usar para establecer variables de clase DataLabel : DataLabels.Item, Point.DataLabel, Trendline.DataLabel y Series.DataLabels

For Each

A continuación, se muestra un ejemplo de cómo procesar los elementos DataLabel en una colección.

Dim dtl As DataLabel
For Each dtl In ActiveCell.Width.DataLabels()
	
Next dtl

Temas

Algunos procedimientos de esta clase se han agrupado en temas y se describen en páginas temáticas separadas

Formula with its procedures Formula, FormulaLocal, FormulaR1C1 y FormulaR1C1Local
Number with its procedures NumberFormatLinked, NumberFormatLocal, DataLabels.NumberFormatLinked y DataLabels.NumberFormatLocal
Sort/Order with its procedures ReadingOrder y DataLabels.ReadingOrder
Display/Show with its procedures ShowBubbleSize, ShowCategoryName, ShowLegendKey, ShowPercentage, ShowRange, ShowSeriesName, DataLabels.ShowBubbleSize, DataLabels.ShowCategoryName, DataLabels.ShowLegendKey, DataLabels.ShowPercentage, DataLabels.ShowRange y DataLabels.ShowSeriesName

Métodos

Los principales métodos de la clase DataLabel son

Delete - Elimina el objeto.

ActiveCell.Width(1).DataLabel.Delete

Select - Selecciona el objeto.

ActiveCell.Width(1).DataLabel.Select

DataLabels.Delete - Elimina el objeto.

ActiveChart.FullSeriesCollection(1).DataLabels.Delete

DataLabels.Select - Selecciona el objeto.

ActiveChart.FullSeriesCollection(1).DataLabels.Select

Otros Métodos

SetProperty -

DataLabels.Item - Devuelve un solo objeto de una colección.

DataLabels.Propagate - Permite tomar el contenido y el formato de una sola etiqueta de datos y aplicarla a todos los demás rótulos de datos de la serie.

DataLabels.SetProperty -

Propiedades

AutoText True si el objeto genera automáticamente un texto apropiado basado en el contexto.

ActiveCell.Width(1).DataLabel.AutoText = True

Caption Devuelve o establece un valor de tipo String que representa el texto del rótulo de datos.

ActiveCell.Width(1).DataLabel.Caption =

Characters Devuelve un objeto Characters que representa un rango de caracteres dentro del texto del objeto.

Dim chrsCharacters As Characters
Set chrsCharacters = ActiveCell.Width(1).DataLabel.Characters

Format Devuelve el objeto ChartFormat .

Dim cftFormatted As ChartFormat
Set cftFormatted = ActiveCell.Width(1).DataLabel.Format

Height Devuelve el alto del objeto en puntos.

ActiveCell.Width(1).DataLabel.Height =

HorizontalAlignment Devuelve o establece un valor de tipo Variant que representa la alineación horizontal del objeto especificado.

ActiveCell.Width(1).DataLabel.HorizontalAlignment = xlHAlignCenter

Left Devuelve o establece un valor de tipo Double que representa la distancia, en puntos, desde el borde izquierdo del objeto al borde izquierdo de la columna a (en una hoja de cálculo) o al borde izquierdo del área del gráfico (en un gráfico).

ActiveCell.Width(1).DataLabel.Left =

Name Devuelve un valor de tipo String que representa el nombre del objeto.

Dim strName As String
strName = ActiveCell.Width(1).DataLabel.Name

NumberFormat Devuelve o establece un valor de tipo String que representa el código de formato del objeto.

ActiveCell.Width(1).DataLabel.NumberFormat =

Orientation Devuelve o establece un valor de tipo Variant que representa la orientación del texto.

ActiveCell.Width(1).DataLabel.Orientation = xlDownward

Parent Devuelve el objeto primario del objeto especificado.

Dim objParent As Object
Set objParent = ActiveCell.Width(1).DataLabel.Parent

Position Devuelve o establece un valor de XlDataLabelPosition que representa la posición del rótulo de datos.

ActiveCell.Width(1).DataLabel.Position = xlLabelPositionAbove

Separator Establece o devuelve un valor de tipo Variant que representa el separador empleado para las etiquetas de datos de un gráfico.

ActiveCell.Width(1).DataLabel.Separator = ";"

Shadow Devuelve o establece un valor de tipo Boolean que determina si el objeto tiene una sombra.

ActiveCell.Width(1).DataLabel.Shadow = True

ShowValue Devuelve o establece un valor de tipo Boolean correspondiente al comportamiento de presentación de valores de rótulos de los datos de un gráfico.

ActiveCell.Width(1).DataLabel.ShowValue = True

Text Devuelve o establece el texto del objeto especificado.

ActiveCell.Width(1).DataLabel.Text =

Top Devuelve o establece un valor de tipo Double que representa la distancia, en puntos, desde el borde superior del objeto hasta la parte superior de la fila 1 (en una hoja de cálculo) o hasta la parte superior del área del gráfico (en un gráfico).

ActiveCell.Width(1).DataLabel.Top =

VerticalAlignment Devuelve o establece un valor de tipo Variant que representa la alineación vertical del objeto especificado.

ActiveCell.Width(1).DataLabel.VerticalAlignment = xlVAlignBottom

Width Devuelve el ancho del objeto en puntos.

ActiveCell.Width(1).DataLabel.Width =

DataLabels.AutoText True si el objeto genera automáticamente un texto apropiado basado en el contexto.

ActiveChart.FullSeriesCollection(1).DataLabels.AutoText = True

DataLabels.Count Devuelve un valor Long que representa el número de objetos de la colección.

Dim lngCount As Long
lngCount = ActiveChart.FullSeriesCollection(1).DataLabels.Count

DataLabels.Format Devuelve el objeto ChartFormat .

Dim cftFormatted As ChartFormat
Set cftFormatted = ActiveChart.FullSeriesCollection(1).DataLabels.Format

DataLabels.HorizontalAlignment Devuelve o establece un valor de tipo Variant que representa la alineación horizontal del objeto especificado.

ActiveChart.FullSeriesCollection(1).DataLabels.HorizontalAlignment = xlHAlignCenter

DataLabels.Name Devuelve un valor de tipo String que representa el nombre del objeto.

Dim strName As String
strName = ActiveChart.FullSeriesCollection(1).DataLabels.Name

DataLabels.NumberFormat Devuelve o establece un valor de tipo String que representa el código de formato del objeto.

ActiveChart.FullSeriesCollection(1).DataLabels.NumberFormat =

DataLabels.Orientation Devuelve o establece un valor de tipo Variant que representa la orientación del texto.

ActiveChart.FullSeriesCollection(1).DataLabels.Orientation = xlDownward

DataLabels.Parent Devuelve el objeto primario del objeto especificado.

Dim objParent As Object
Set objParent = ActiveChart.FullSeriesCollection(1).DataLabels.Parent

DataLabels.Position Devuelve o establece un valor de XlDataLabelPosition que representa la posición del rótulo de datos.

ActiveChart.FullSeriesCollection(1).DataLabels.Position = xlLabelPositionAbove

DataLabels.Separator Establece o devuelve un valor de tipo Variant que representa el separador empleado para las etiquetas de datos de un gráfico.

ActiveChart.FullSeriesCollection(1).DataLabels.Separator = ";"

DataLabels.Shadow Devuelve o establece un valor de tipo Boolean que determina si el objeto tiene una sombra.

ActiveChart.FullSeriesCollection(1).DataLabels.Shadow = True

DataLabels.ShowValue Devuelve o establece un valor de tipo Boolean correspondiente al comportamiento de presentación de valores de rótulos de los datos de un gráfico.

ActiveChart.FullSeriesCollection(1).DataLabels.ShowValue = True

DataLabels.VerticalAlignment Devuelve o establece un valor de tipo Variant que representa la alineación vertical del objeto especificado.

ActiveChart.FullSeriesCollection(1).DataLabels.VerticalAlignment = xlVAlignBottom