Legend 클래스

정의

네임스페이스:

System.Windows.Forms.DataVisualization.Charting

어셈블리:

System.Windows.Forms.DataVisualization.dll

차트 이미지에 대한 범례를 나타냅니다.

public ref class Legend : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement

public class Legend : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement

type Legend = class
    inherit ChartNamedElement

Public Class Legend
Inherits ChartNamedElement

상속

Object

ChartElement

ChartNamedElement

Legend

설명

Legend 클래스의 모든 기능을 캡슐화 합니다 Chart 컨트롤의 범례 및 사용 하 여 노출 되는 Legends 루트 컬렉션 속성 Chart 개체.

임의 개수의 범례는 차트 이미지에 있을 수 있습니다.

범례는 다음 작업을 수행할 수 있습니다.

• 도킹 하 고 정렬 합니다.

• 내부 또는 그려진된 차트 영역 외부에 표시 됩니다.

• 내용에 자동으로 맞춥니다.

• 행, 열 또는 테이블과 같은 미리 정의 된 스타일을 사용 합니다.

• 빗살 무늬, 그라데이션 색과 배경 이미지를 사용 합니다.

• 크기가 정 해지고 차트 이미지 내 임의의 위치에 배치 합니다.

범례 항목으로 표시 됩니다는 LegendItem 개체를 기본 또는 사용자 지정 항목. 사용자 지정 항목 데이터와 연결 되지 및 추가할 수 있습니다, 삭제 및 사용 하 여 수정 된 CustomItems 속성입니다.

기본 항목 기본적으로 범례에 자동으로 추가 되며 도넛형 차트, 원형 차트에 그려진된 데이터 요소의 이름입니다.

다른 모든 차트 종류에 대 한 기본 항목은 그려진된 데이터 계열의 이름입니다. 각 계열에는 Legend 사용할 범례의 이름을 정의 하는 속성입니다. 경우 범례 항목 계열에 대해 생성 되지 것입니다 합니다 IsVisibleInLegend 속성이 false합니다. 사용 하 여 이러한 기본 항목에 대 한 텍스트를 변경할 수는 LegendText 속성입니다. 이 속성을 사용 하면 런타임에 적절 한 값을 기준으로 바뀌어 있는 미리 정의 된 키워드를 지정할 수 있습니다.

원형 차트를 설정한 경우는 Label 속성에 설정 됩니다 범례 텍스트 레이블에 대해 설정한 값입니다. 다른 값으로 텍스트를 설정 하려는 경우 설정할 수 있습니다는 LegendText 속성입니다. 대부분의 경우에 설정 하려는 LegendText 속성을 "#AXISLABEL" 또는 "#VALX"입니다.

범례의 계열 기호 줄, 점 또는 사각형이 됩니다. 기호 형식이 차트에서 자동으로 설정 됩니다 및 그려진된 차트 종류에 따라 달라 집니다.

기본적으로 범례 텍스트 크기가 자동으로 조정 합니다. 범례 텍스트의 자동 크기 조정을 사용 하지 않도록 설정 하 여 비활성화할 수 있습니다는 IsTextAutoFit 속성입니다. 이 속성 설정 된 경우 false, 범례 텍스트의 크기를 범례 크기 속성에 의해 결정 됩니다 Font합니다. 경우는 IsTextAutoFit 속성을 사용 합니다 AutoFitMinFontSize 속성 크기를 조정할 때 범례 항목을 가질 수 있는 최소 글꼴 크기를 결정 합니다.

TextWrapThreshold 속성은 다른 줄 바꿈 되기 전에 한 줄에 표시 될 수 있는 문자 수의 한도 정의 합니다. 범례에서 텍스트를 줄 바꿈 하지 않을 경우의 값을 설정 합니다 TextWrapThreshold 속성을 0입니다. 기본적으로 범례에 전체 범례 텍스트를 넣을 수 없는 경우 텍스트는 잘립니다. 설정할 수 있습니다는 TextWrapThreshold 잘리는 대신 줄에 텍스트에 범례에 있습니다.

범례의 내용을 지정 된 공간에 맞지 않는, 범례 항목이 잘립니다. 범례에 대 한 공간이 보다 더 많은 항목이 있는지를 나타내기 위해 줄임표가 표시 됩니다. 범례 항목 잘리지를 방지 하려면 사용 하 여 범례 크기와 위치를 설정 합니다 Position 속성입니다. 범례 위치 또는 크기를 설정 하는 경우 차트는 차트에서 요소를 더 이상 자동으로 배치할 수 없습니다. 경우에 따라 여러 해야 수동으로 원하는 모양으로 표시를 위해 다른 차트 요소를 배치 합니다.

또 다른 옵션 기본 범례 설정을 사용 하는 대신 사용자 고유의 셀 열을 정의 하는 것입니다.

Legend 개체 CellColumn 컬렉션에는 각 CellColumn 개체 범례에 열을 나타냅니다. 셀 열에 MaximumWidth 고 MinimumWidth 열의 크기를 조정 하려면 사용할 수 있는 속성입니다.

범례에 항목이 많은 경우 InterlacedRows 가독성을 개선 하기 위해 사용할 수 있습니다. 이 속성이 True로 표시 됩니다. 사용 하 여 설정할 수 있는 배경색을 InterlacedRowsColor 속성입니다.

기본적으로 범례는 차트의 오른쪽 위 모퉁이에 배치 됩니다. 이 위치를 사용 하 여 수정할 수는 Docking 고 Alignment 범례 속성입니다. 범례가 차트 영역을 사용 하 여 연결할 수도 있습니다는 DockedToChartArea 속성입니다. 이 속성에는 범례가 도킹할 차트 영역의 이름을 지정 합니다. 또한는 IsDockedInsideChartArea 차트 영역 내부에 범례를 표시 하려면 속성을 사용할 수 있습니다.

때 IsDockedInsideChartArea False로 설정 되는 MaximumAutoSize 속성은 범례를 자동으로 배치 하는 경우 사용 가능한 차트 범례의 백분율의 최대 크기를 정의 합니다. 너비 또는 높이 범례 도킹 속성을 설정한 후 조정 하려는 경우이 속성을 설정 해야 합니다.

범례를 사용 하 여 수정할 수 있습니다는 CustomizeLegend 이벤트입니다.

생성자

Legend()	Legend 클래스의 새 인스턴스를 초기화합니다.
Legend(String)	지정된 범례 이름을 사용하여 Legend 클래스의 새 인스턴스를 초기화합니다.

속성

Alignment	범례의 맞춤을 가져오거나 설정합니다.
AutoFitMinFontSize	범례 텍스트에 대한 자동 맞춤 알고리즘에서 사용할 수 있는 최소 글꼴 크기를 가져오거나 설정합니다.
BackColor	범례의 배경색을 가져오거나 설정합니다.
BackGradientStyle	범례의 배경 그라데이션 방향을 가져오거나 설정합니다. 또한 그라데이션의 사용 여부를 결정합니다.
BackHatchStyle	범례의 빗살 무늬 스타일을 가져오거나 설정합니다.
BackImage	범례의 배경 이미지를 가져오거나 설정합니다.
BackImageAlignment	Unscaled 그리기 모드에 사용되는 배경 이미지 맞춤을 가져오거나 설정합니다.
BackImageTransparentColor	배경 이미지를 그릴 때 투명한 색으로 바꿀 색을 가져오거나 설정합니다.
BackImageWrapMode	범례 배경 이미지 그리기 모드를 가져오거나 설정합니다.
BackSecondaryColor	범례 배경의 보조 색을 가져오거나 설정합니다.
BorderColor	범례의 테두리 색을 가져오거나 설정합니다.
BorderDashStyle	범례의 테두리 스타일을 가져오거나 설정합니다.
BorderWidth	범례의 테두리 너비를 가져오거나 설정합니다.
CellColumns	범례의 셀 열 컬렉션을 포함하는 LegendCellColumnCollection 개체를 가져옵니다.
CustomItems	사용자 지정 범례 항목에 사용되는 LegendItemsCollection 개체를 가져옵니다.
DockedToChartArea	범례가 도킹될 ChartArea의 이름을 가져오거나 설정합니다.
Docking	범례가 도킹할지 여부를 결정하는 값을 가져오거나 설정합니다.
Enabled	범례가 사용되는지 여부를 나타내는 값을 가져오거나 설정합니다.
Font	범례의 글꼴 속성을 설정하는 데 사용되는 Font 개체를 가져오거나 설정합니다.
ForeColor	범례 텍스트의 색을 가져오거나 설정합니다.
HeaderSeparator	범례 머리글의 시각적 구분 기호 유형을 가져오거나 설정합니다.
HeaderSeparatorColor	범례 머리글에 대한 구분 기호의 색을 가져오거나 설정합니다.
InsideChartArea	범례가 그려지는 차트 영역의 이름을 가져오거나 설정합니다.
InterlacedRows	범례 행을 인터레이스된 배경색으로 그릴지 여부를 나타내는 플래그를 가져오거나 설정합니다.
InterlacedRowsColor	범례의 인터레이스된 행의 배경색을 가져오거나 설정합니다.
IsDockedInsideChartArea	범례가 차트 영역 내부에 도킹되는지 또는 외부에 도킹되는지 나타내는 플래그를 가져오거나 설정합니다.
IsEquallySpacedItems	모든 범례 항목의 간격이 같은지 여부를 나타내는 플래그를 가져오거나 설정합니다.
IsTextAutoFit	범례 텍스트의 크기가 자동으로 조정되는지 여부를 나타내는 플래그를 가져오거나 설정합니다.
ItemColumnSeparator	범례 테이블 열의 시각적 구분 기호 유형을 가져오거나 설정합니다.
ItemColumnSeparatorColor	범례 테이블 열 구분 기호의 색을 가져오거나 설정합니다.
ItemColumnSpacing	범례 테이블 열 간격을 가져오거나 설정합니다.
LegendItemOrder	범례 항목이 표시되는 순서를 지정하는 값을 가져오거나 설정합니다. 이 속성은 차트 계열에 대해 자동으로 추가된 범례 항목에만 영향을 주며, 사용자 지정 범례 항목에는 영향을 주지 않습니다.
LegendStyle	범례의 스타일을 가져오거나 설정합니다.
MaximumAutoSize	차트 영역의 백분율로 측정되는 범례의 최대 크기를 가져오거나 설정합니다. 이 값은 자동 레이아웃 알고리즘에 사용됩니다.
Name	범례의 이름을 가져오거나 설정합니다.
Position	범례의 위치를 가져오거나 설정하는 데 사용할 수 있는 ElementPosition 개체를 가져오거나 설정합니다.
ShadowColor	범례의 그림자 색을 가져오거나 설정합니다.
ShadowOffset	범례의 그림자 오프셋(픽셀)을 가져오거나 설정합니다.
TableStyle	범례 테이블 스타일을 가져오거나 설정합니다.
Tag	이 차트 요소와 연결된 개체를 가져오거나 설정합니다. (다음에서 상속됨 ChartElement)
TextWrapThreshold	텍스트가 줄 바꿈되기 전에 범례에서 연속적으로 표시할 수 있는 문자 수를 가져오거나 설정합니다.
Title	범례 제목의 텍스트를 가져오거나 설정합니다.
TitleAlignment	범례 제목의 맞춤을 가져오거나 설정합니다.
TitleBackColor	범례 제목의 배경색을 가져오거나 설정합니다.
TitleFont	범례 제목의 글꼴을 가져오거나 설정합니다.
TitleForeColor	범례 제목의 텍스트 색을 가져오거나 설정합니다.
TitleSeparator	범례 제목의 시각적 구분 기호 유형을 가져오거나 설정합니다.
TitleSeparatorColor	범례 제목 구분 기호의 색을 가져오거나 설정합니다.

메서드

Dispose()	ChartElement에서 사용하는 리소스를 해제합니다. (다음에서 상속됨 ChartElement)
Dispose(Boolean)	Legend에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.
Equals(Object)	지정한 Object가 현재 ChartElement와 같은지 여부를 확인합니다. (다음에서 상속됨 ChartElement)
GetHashCode()	특정 형식에 대한 해시 함수를 반환합니다. (다음에서 상속됨 ChartElement)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 Object를 나타내는 문자열을 반환합니다. (다음에서 상속됨 ChartElement)