Class Legend

Class Legend

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

Інкапсулює об’єкт, який представляє легенду графіка.

public class Legend : ChartTextFrame

Наслідування

object ← ChartFrame ← ChartTextFrame ← Legend

Наслідувані члени

ChartTextFrame.m_IsAutoText, ChartTextFrame.m_deleted, ChartTextFrame.horizontal, ChartTextFrame.vertical, ChartTextFrame.rotation, ChartTextFrame.m_CharsList, ChartTextFrame.Characters(int, int), ChartTextFrame.IsAutoText, ChartTextFrame.IsDeleted, ChartTextFrame.TextHorizontalAlignment, ChartTextFrame.TextVerticalAlignment, ChartTextFrame.RotationAngle, ChartTextFrame.IsAutomaticRotation, ChartTextFrame.Text, ChartTextFrame.LinkedSource, ChartTextFrame.ReadingOrder, ChartTextFrame.DirectionType, ChartTextFrame.IsTextWrapped, ChartTextFrame.IsResizeShapeToFitText, ChartFrame.m_IsAutoXPos, ChartFrame.m_IsAutoYPos, ChartFrame.m_IsOffsetPosBeSet, ChartFrame.m_fontIndex, ChartFrame.m_AutoScaleFont, ChartFrame.m_BackgroundMode, ChartFrame.m_isAutoSize, ChartFrame.SetPositionAuto(), ChartFrame.IsInnerMode, ChartFrame.Border, ChartFrame.Area, ChartFrame.TextOptions, ChartFrame.Font, ChartFrame.AutoScaleFont, ChartFrame.BackgroundMode, ChartFrame.IsAutomaticSize, ChartFrame.X, ChartFrame.Y, ChartFrame.Height, ChartFrame.Width, ChartFrame.Shadow, ChartFrame.ShapeProperties, ChartFrame.IsDefaultPosBeSet, ChartFrame.DefaultX, ChartFrame.DefaultY, ChartFrame.DefaultWidth, ChartFrame.DefaultHeight, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Приклади 

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

Cells cells = sheet.Cells;
cells[0,1].PutValue("Дохід");
cells[1,0].PutValue("Компанія A");
cells[2,0].PutValue("Компанія B");
cells[3,0].PutValue("Компанія C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);

int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);
Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
//Встановити ширину та висоту легенди
Legend legend = chart.Legend;

//Легенда за замовчуванням знаходиться з правого боку графіка.
//Якщо легенда зліва або справа від графіка, встановлення властивості Legend.X не матиме ефекту.
//Якщо легенда зверху або знизу графіка, встановлення властивості Legend.Y не матиме ефекту.
legend.Y = 1500;
legend.Width = 50;
legend.Height = 50; 
//Встановити позицію легенди
legend.Position = LegendPositionType.Left;
Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)

Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Дохід")
cells(1,0).PutValue("Компанія A")
cells(2,0).PutValue("Компанія B")
cells(3,0).PutValue("Компанія C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)

Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)

Dim chart as Chart = sheet.Charts(chartIndex)
chart.SetChartDataRange("A1:B4", True);

'Встановити ширину та висоту легенди
Dim legend as Legend = chart.Legend

'Легенда за замовчуванням знаходиться з правого боку графіка.
'Якщо легенда зліва або справа від графіка, встановлення властивості Legend.X не матиме ефекту.
'Якщо легенда зверху або знизу графіка, встановлення властивості Legend.Y не матиме ефекту.
legend.Y = 1500
legend.Width = 50
legend.Height = 50
'Встановити позицію легенди
legend.Position = LegendPositionType.Left

Властивості

IsOverLay

Отримує або встановлює, чи показується легенда без перекриття графіка.

public bool IsOverLay { get; set; }

Значення властивості

bool

LegendEntries

Отримує колекцію всіх об’єктів LegendEntry у вказаній легенді графіка. Встановлення записів легенди для поверхневого графіка не підтримується. Тому поверне null, якщо тип графіка - поверхневий графік.

public LegendEntryCollection LegendEntries { get; }

Значення властивості

LegendEntryCollection

Position

Отримує або встановлює тип позиції легенди.

public LegendPositionType Position { get; set; }

Значення властивості

LegendPositionType

Зауваження


Типова позиція - справа.
Якщо легенда зліва або справа від графіка, встановлення властивості Legend.X не матиме ефекту.
Якщо легенда зверху або знизу графіка, встановлення властивості Legend.Y не матиме ефекту.

Методи

GetLegendLabels()

Отримує мітки записів легенди після виклику методу Chart.Calculate().

public string[] GetLegendLabels()

Повертає

string[]

 Українська