다음을 통해 공유

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 모든 기능을 캡슐화하고 루트 Chart 개체의 컬렉션 속성을 사용하여 Legends 노출됩니다.

차트 이미지에 대한 범례는 여러 개 있을 수 있습니다.

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

  • 도킹하고 정렬합니다.

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

  • 콘텐츠에 자동으로 맞습니다.

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

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

  • 차트 이미지 내의 모든 위치에 크기를 조정하고 배치합니다.

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

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

다른 모든 차트 유형의 경우 기본 항목은 그려진 데이터 계열의 이름입니다. 각 계열에는 Legend 사용할 범례의 이름을 정의하는 속성이 있습니다. 속성이 으로 설정된 false경우 계열에 대한 범례 IsVisibleInLegend 항목이 만들어지지 않습니다. 이러한 기본 항목에 대한 텍스트는 속성을 사용하여 LegendText 변경할 수 있습니다. 이 속성을 사용하면 런타임에 해당 값으로 대체될 미리 정의된 키워드를 지정할 수 있습니다.

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

범례 계열 기호는 사각형, 점 또는 선입니다. 기호 형식은 차트에 의해 자동으로 설정되며 표시된 차트 종류에 따라 달라집니다.

범례 텍스트는 기본적으로 자동으로 크기가 조정됩니다. 속성을 사용하지 않도록 설정하여 범례 텍스트의 자동 크기 조정을 IsTextAutoFit 사용하지 않도록 설정할 수 있습니다. 이 속성을 설정 false하면 범례 텍스트의 크기는 범례의 Size 속성에 Font의해 결정됩니다. IsTextAutoFit 속성을 사용하도록 설정하면 속성은 AutoFitMinFontSize 크기 조정 시 범례 항목에 사용할 수 있는 최소 글꼴 크기를 결정합니다.

이 속성은 TextWrapThreshold 텍스트가 다른 줄로 래핑되기 전에 한 줄에 표시될 수 있는 문자 수에 대한 제한을 정의합니다. 범례에서 텍스트를 줄 바꿈하지 않으려면 속성 값을 TextWrapThreshold 0으로 설정합니다. 기본적으로 전체 범례 텍스트가 범례에 맞지 않으면 텍스트가 잘립니다. 범례를 TextWrapThreshold 설정하여 잘리는 대신 줄 바꿈할 텍스트를 가져올 수 있습니다.

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

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

Legend 개체에는 CellColumn 컬렉션이 있습니다. 각 CellColumn 개체는 Legend의 열을 나타냅니다. 셀 열에는 MaximumWidthMinimumWidth 열의 크기를 조정하는 데 사용할 수 있는 속성이 있습니다.

범례에 많은 항목 InterlacedRows 이 포함된 경우 가독성을 향상시키는 데 사용할 수 있습니다. 이 속성을 True로 설정하면 속성을 사용하여 설정할 수 있는 후면 색이 InterlacedRowsColor 표시됩니다.

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

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

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

생성자

Name Description
Legend()

Legend 클래스의 새 인스턴스를 초기화합니다.
Legend(String)

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

속성

Name Description
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

범례 제목 구분 기호의 색을 가져오거나 설정합니다.

메서드

Name Description
Dispose()

에서 사용하는 ChartElement리소스를 해제합니다.

(다음에서 상속됨 ChartElement)
Dispose(Boolean)

관리되지 않는 리소스를 Legend 해제하고 관리되는 리소스를 선택적으로 해제합니다.
Equals(Object)

지정된 Object 값이 현재 ChartElement와 같은지 여부를 확인합니다.

(다음에서 상속됨 ChartElement)
GetHashCode()

특정 형식에 대한 해시 함수를 반환합니다.

(다음에서 상속됨 ChartElement)
GetType()

현재 인스턴스의 Type 가져옵니다.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
ToString()

현재 Object를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 ChartElement)

적용 대상