Chart.ApplyDataLabels - метод

Статья
08/11/2011

Применяет подписи данных к точке, ряду или всем рядам в элементе управления Chart.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)

Синтаксис

'Декларация
Sub ApplyDataLabels ( _
    Type As XlDataLabelsType, _
    LegendKey As Object, _
    AutoText As Object, _
    HasLeaderLines As Object, _
    ShowSeriesName As Object, _
    ShowCategoryName As Object, _
    ShowValue As Object, _
    ShowPercentage As Object, _
    ShowBubbleSize As Object, _
    Separator As Object _
)

void ApplyDataLabels(
    XlDataLabelsType Type,
    Object LegendKey,
    Object AutoText,
    Object HasLeaderLines,
    Object ShowSeriesName,
    Object ShowCategoryName,
    Object ShowValue,
    Object ShowPercentage,
    Object ShowBubbleSize,
    Object Separator
)

Параметры

Type
Тип: Microsoft.Office.Interop.Excel.XlDataLabelsType
XlDataLabelsType.Тип применяемой подписи данных.

LegendKey
Тип: System.Object
Значение true используется для отображения ключа легенды рядом с точкой.Значение по умолчанию — false.

AutoText
Тип: System.Object
Имеет значение true, если объект автоматически создает текст, исходя из содержимого.

HasLeaderLines
Тип: System.Object
Для объектов Chart и Series имеет значение true, если ряд имеет линии выноски.

ShowSeriesName
Тип: System.Object
Имя ряда для подписи данных.

ShowCategoryName
Тип: System.Object
Имя категории для подписи данных.

ShowValue
Тип: System.Object
Значение для подписи данных.

ShowPercentage
Тип: System.Object
Относительное значение для подписи данных.

ShowBubbleSize
Тип: System.Object
Размеры пузырьков для подписи данных.

Separator
Тип: System.Object
Разделитель для подписи данных.

Заметки

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода создается объект Chart, после чего метод ApplyDataLabels используется для отображения на диаграмме сигнатур данных с именами рядов.

Private Sub DisplayLabels()
    Me.Range("A1", "A5").Value2 = 22
    Me.Range("B1", "B5").Value2 = 55

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
        Me.Controls.AddChart(Me.Range("D2", "H20"), "Chart1")

    Chart1.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType.xlBarClustered

    Chart1.ApplyDataLabels(Excel.XlDataLabelsType.xlDataLabelsShowLabel, _
        False, False, False, True, False, False, False, False, False)
End Sub

private void DisplayLabels()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["D2", "H20"], 
        "chart1");

    chart1.SetSourceData(this.Range["A1", "B5"], 
        Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlBarClustered;

    chart1.ApplyDataLabels(
        Excel.XlDataLabelsType.xlDataLabelsShowLabel,
        false, false, false, true, false, false, false, 
        false, false);
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

Chart Интерфейс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через