Bar3DSeries QML Type (Uncreatable)

3D 막대 그래프로 데이터 시계를 나타냅니다. 더 보기...

참고: 이 타입은 생성할 수 없습니다. QML에서 인스턴스화할 수 없습니다.

• 상속된 멤버를 포함한 모든 멤버 목록
• Bar3DSeries는 3D용 QML 유형인 ‘Qt Graphs ’의 일부입니다.

속성

• baseColor : color
• baseGradient : Gradient
• colorStyle : GraphsTheme.ColorStyle
• columnLabels : list
• dataArray : BarDataArray
• dataProxy : BarDataProxy
• invalidSelectionPosition : point
• itemLabel : string
• itemLabelFormat : string
• itemLabelVisible : bool
• lightingMode : Abstract3DSeries.LightingMode (since 6.10)
• mesh : Abstract3DSeries.Mesh
• meshAngle : real
• meshRotation : quaternion
• meshSmooth : bool
• multiHighlightColor : color
• multiHighlightGradient : Gradient
• name : string
• rowColors : list<Color>
• rowLabels : list
• selectedBar : point
• singleHighlightColor : color
• singleHighlightGradient : Gradient
• type : Abstract3DSeries.SeriesType
• userDefinedMesh : string
• visible : bool

신호

• baseColorChanged(color color)
• baseGradientChanged(Gradient gradient)
• colorStyleChanged(GraphsTheme.ColorStyle style)
• columnLabelsChanged()
• dataArrayChanged(BarDataArray array)
• dataProxyChanged(BarDataProxy proxy)
• itemLabelChanged(string label)
• itemLabelFormatChanged(string format)
• itemLabelVisibilityChanged(bool visible)
• lightingModeChanged(Abstract3DSeries.LightingMode lightingMode) (since 6.10)
• meshAngleChanged(real angle)
• meshChanged(Abstract3DSeries.Mesh mesh)
• meshRotationChanged(quaternion rotation)
• meshSmoothChanged(bool enabled)
• multiHighlightColorChanged(color color)
• multiHighlightGradientChanged(Gradient gradient)
• nameChanged(string name)
• rowColorsChanged(list<color> rowcolors)
• rowLabelsChanged()
• selectedBarChanged(point position)
• singleHighlightColorChanged(color color)
• singleHighlightGradientChanged(Gradient gradient)
• userDefinedMeshChanged(string fileName)
• visibilityChanged(bool visible)

방법

• void setMeshAxisAndAngle(vector3d axis, real angle)

상세 설명

이 유형은 시리즈 데이터(데이터 프록시를 통해)뿐만 아니라 시리즈 고유의 시각적 요소도 관리합니다.

Bar3DSeries는 itemLabelFormat에 대해 다음 형식 태그를 지원합니다:

더 자세한 설명은 QBar3DSeries 를 참조하십시오.

Qt Graphs 의 ‘3D를 사용한 데이터 처리’항목도 참조하십시오 .

속성 설명서

baseColor : color

이 시리즈의 기본 색상입니다.

colorStyle 및 GraphsTheme.seriesColors도 참조하십시오 .

baseGradient : Gradient

이 수열의 기본 기울기.

colorStyle도 참조하십시오 .

colorStyle : GraphsTheme.ColorStyle

이 시리즈의 색상 스타일.

GraphsTheme.ColorStyle도 참조하십시오 .

columnLabels : list

배열에 대한 선택적 열 레이블입니다. 이 배열의 인덱스는 행의 열 인덱스와 일치합니다. 목록의 길이가 가장 긴 행보다 짧을 경우, 모든 열에 레이블이 지정되지는 않습니다.

dataArray : BarDataArray

데이터 배열의 참조를 보유합니다.

dataArrayChanged newDataArray 가 이전 것과 동일하지 않은 경우, 데이터 배열이 설정되면 신호가 발생합니다.

dataProxy : BarDataProxy

활성 데이터 프록시. 이 시계열은 자신에게 설정된 모든 프록시의 소유권을 가지며, 새로운 프록시가 추가되면 이전에 설정된 프록시는 모두 삭제합니다. 프록시는 null이거나 다른 시계열로 설정되어서는 안 됩니다.

invalidSelectionPosition : point [read-only]

선택에 유효하지 않은 위치를 제공하는 상수 속성입니다. 이 위치는 selectedBar 속성에 할당되어 이 시리즈에서 선택을 해제합니다.

GraphsItem3D.clearSelection()도 참조하십시오 .

itemLabel : string [read-only]

서식이 적용된 항목 레이블입니다. 선택된 항목이 없거나 선택된 항목이 표시되지 않는 경우, 빈 문자열을 반환합니다.

itemLabelFormat도 참조하십시오 .

itemLabelFormat : string

이 시리즈의 데이터 항목에 대한 레이블 형식입니다. 이 형식은 단일 항목 레이블에 사용되며, 예를 들어 항목이 선택되었을 때 적용됩니다. 이 형식이 어떻게 해석되는지는 시리즈 유형에 따라 다릅니다.

Bar3DSeries, Scatter3DSeries 및 Surface3DSeries도 참조하십시오 .

itemLabelVisible : bool

true 인 경우, 항목 레이블은 그래프 내에 플로팅 레이블로 표시됩니다. 그렇지 않은 경우, 항목 레이블은 표시되지 않습니다. 외부 컨트롤에 항목 레이블을 표시하려면 이 속성을 false 로 설정합니다. 기본값은 true 입니다.

itemLabelFormat 및 itemLabel항목도 참조하십시오 .

lightingMode : Abstract3DSeries.LightingMode [since 6.10]

시리즈 내 항목의 조명 모드입니다. 기본값은 QAbstract3DSeries::LightingMode::Shaded

이 속성은 Qt 6.10에서 도입되었습니다.

QAbstract3DSeries::LightingMode도 참조하십시오 .

mesh : Abstract3DSeries.Mesh

시리즈에 포함된 항목의 메시, 또는 Surface3DSeries 의 경우 선택 포인터입니다. 메시가 Abstract3DSeries.Mesh.UserDefined 인 경우, 항목이 제대로 렌더링되려면 userDefinedMesh 속성도 설정해야 합니다. 기본값은 그래프 유형에 따라 다릅니다.

QAbstract3DSeries::Mesh도 참조하십시오 .

meshAngle : real

시리즈 회전 각도를 도(°) 단위로 정의하는 편리한 속성입니다.

참조: Abstract3DSeries.meshRotation.

meshRotation : quaternion

시리즈의 모든 항목에 적용되는 메쉬 회전입니다. 회전 값은 정규화된 쿼터니언이어야 합니다. 항목별 회전을 지원하는 시리즈 유형의 경우, 각 회전이 서로 곱해집니다. ` Bar3DSeries `은 y축을 중심으로 하지 않는 회전은 모두 무시합니다. ` Surface3DSeries `은 선택 포인터에만 회전을 적용합니다. 기본값은 회전 없음입니다.

meshSmooth : bool

true 인 경우, mesh 속성을 통해 설정된 사전 정의된 메시의 스무딩 버전이 사용됩니다. 이 속성은 메시가 Abstract3DSeries.Mesh.UserDefined 로 설정되었을 때 사용되는 사용자 정의 메시에는 영향을 미치지 않습니다. 기본값은 false 입니다.

multiHighlightColor : color

시리즈의 여러 항목을 강조 표시하는 색상입니다.

colorStyle 및 GraphsTheme.multiHighlightColor도 참조하십시오 .

multiHighlightGradient : Gradient

이 시리즈의 여러 항목을 강조 표시하는 그라데이션.

colorStyle 및 GraphsTheme.multiHighlightGradient도 참조하십시오 .

name : string

시리즈 이름입니다. @seriesName 태그를 사용하여 항목 레이블 형식으로 사용할 수 있습니다.

itemLabelFormat도 참조하십시오 .

rowColors : list<Color>

이 속성을 사용하면 시계의 행을 서로 다른 색상으로 그릴 수 있습니다. 이 속성을 사용하려면 ‘ GraphsTheme.colorStyle ’을 ‘ Uniform ’로 설정해야 합니다.

참조: QGraphsTheme::ColorStyle::Uniform.

rowLabels : list

배열에 대한 선택적 행 레이블입니다. 이 배열의 인덱스는 데이터 배열의 행 인덱스와 일치합니다. 목록의 길이가 행 수보다 짧을 경우, 모든 행에 레이블이 지정되지 않습니다.

selectedBar : point

시리즈에서 선택된 막대입니다.

선택된 막대의 위치는 시리즈의 데이터 배열 내 행과 열로 지정됩니다.

한 번에 하나의 막대만 선택할 수 있습니다.

이 시리즈에서 선택을 해제하려면 위치로 ` invalidSelectionPosition `를 지정하십시오.

이 시리즈가 그래프에 추가되면, 그래프는 사용자 상호 작용에 따라 또는 선택이 무효화될 경우 선택을 조정할 수 있습니다. 추가된 다른 시리즈에서 막대를 선택해도 선택이 해제됩니다.

시리즈에서 행을 제거하거나 선택된 막대의 행 앞에 행을 삽입하면, 동일한 막대가 선택된 상태로 유지되도록 선택이 조정됩니다.

GraphsItem3D.clearSelection()도 참조하십시오 .

singleHighlightColor : color

이 시리즈의 개별 항목 강조 색상입니다.

colorStyle 및 GraphsTheme.singleHighlightColor도 참조하십시오 .

singleHighlightGradient : Gradient

이 시리즈의 단일 아이템 하이라이트 그라데이션입니다.

colorStyle 및 GraphsTheme.singleHighlightGradient도 참조하십시오 .

type : Abstract3DSeries.SeriesType [read-only]

시리즈의 유형. ` QAbstract3DSeries::SeriesType ` 값 중 하나입니다.

userDefinedMesh : string

mesh 가 사용될 때 오브젝트에 대한 사용자 정의 메쉬의 파일 이름은 Abstract3DSeries.Mesh.UserDefined 입니다.

visible : bool

시리즈의 표시 여부. false 인 경우, 해당 시리즈는 렌더링되지 않습니다.

Signal 문서

baseColorChanged(color color)

이 신호는 ‘ baseColor ’가 ‘ color ’로 변경될 때 발생합니다.

baseGradientChanged(Gradient gradient)

이 신호는 baseGradient 이 gradient 로 변경될 때 발생합니다.

colorStyleChanged(GraphsTheme.ColorStyle style)

이 신호는 colorStyle 이 style 로 변경될 때 발생합니다.

columnLabelsChanged()

이 신호는 열 레이블이 변경될 때 발생합니다.

dataArrayChanged(BarDataArray array)

이 신호는 dataArray 이 array 로 변경될 때 발생합니다.

dataProxyChanged(BarDataProxy proxy)

이 신호는 dataProxy 이 proxy 로 변경될 때 발생합니다.

itemLabelChanged(string label)

이 신호는 itemLabel 가 label 로 변경될 때 발생합니다.

itemLabelFormatChanged(string format)

이 신호는 itemLabelFormat 가 format 로 변경될 때 발생합니다.

itemLabelVisibilityChanged(bool visible)

이 신호는 itemLabelVisibility가 ‘ visible ’로 변경될 때 발생합니다.

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

이 신호는 lightingMode 이 lightingMode 으로 변경될 때 발생합니다.

이 신호는 Qt 6.10에서 도입되었습니다.

meshAngleChanged(real angle)

이 신호는 meshAngle 이 angle 로 변경될 때 발생합니다.

meshChanged(Abstract3DSeries.Mesh mesh)

이 신호는 mesh 가 mesh 로 변경될 때 발생합니다.

meshRotationChanged(quaternion rotation)

이 신호는 meshRotation 이 rotation 로 변경될 때 발생합니다.

meshSmoothChanged(bool enabled)

이 신호는 meshSmooth 가 enabled 로 변경될 때 발생합니다.

multiHighlightColorChanged(color color)

이 신호는 multiHighlightColor 이 color 로 변경될 때 발생합니다.

multiHighlightGradientChanged(Gradient gradient)

이 신호는 multiHighlightGradient 가 gradient 로 변경될 때 발생합니다.

nameChanged(string name)

이 신호는 name 이 name 으로 변경될 때 발생합니다.

rowColorsChanged(list<color> rowcolors)

이 신호는 rowColors 이 rowcolors 로 변경될 때 발생합니다.

rowLabelsChanged()

이 신호는 행 레이블이 변경될 때 발생합니다.

selectedBarChanged(point position)

이 신호는 selectedBar 이 position 로 변경될 때 발생합니다.

singleHighlightColorChanged(color color)

이 신호는 singleHighlightColor 가 color 로 변경될 때 발생합니다.

singleHighlightGradientChanged(Gradient gradient)

이 신호는 singleHighlightGradient 이 gradient 로 변경될 때 발생합니다.

userDefinedMeshChanged(string fileName)

이 신호는 userDefinedMesh 이 fileName 로 변경될 때 발생합니다.

visibilityChanged(bool visible)

이 신호는 시리즈의 표시 상태가 ‘ visible ’로 변경될 때 발생합니다.

메서드 문서

void setMeshAxisAndAngle(vector3d axis, real angle)

axis 와 angle 를 사용하여 메쉬 회전 쿼터니언을 생성하는 편리한 함수입니다.

meshRotation도 참조하십시오 .