Path QML Type
PathView 및 Shape 에서 사용할 경로를 정의합니다. 더 보기...
Import Statement: | import QtQuick |
Inherited By: |
속성
- closed : bool
- pathElements : list<PathElement>
- scale : size
(since QtQuick 2.14)
- simplify : bool
(since 6.6)
- startX : real
- startY : real
방법
- point pointAtPercent(real t)
(since QtQuick 2.14)
상세 설명
경로는 하나 이상의 경로 세그먼트( PathLine, PathPolyline, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg)로 구성됩니다.
경로에 있는 항목의 간격은 PathPercent 객체를 통해 조정할 수 있습니다.
PathAttribute 를 사용하면 경로를 따라 값을 가진 명명된 속성을 정의할 수 있습니다.
Path 및 경로 요소 지정을 위한 다른 유형은 PathView 와 Shape 에서 공유됩니다. 다음 표는 다양한 경로 요소의 적용 가능성에 대한 개요를 제공합니다:
요소 | PathView | 모양 | 모양, 소프트웨어 |
---|---|---|---|
PathMove | N/A | 예 | 예 |
PathLine | 예 | 예 | 예 |
PathPolyline | 예 | 예 | 예 |
PathMultiline | 예 | 예 | 예 |
PathQuad | 예 | 예 | 예 |
PathCubic | 예 | 예 | 예 |
PathArc | 예 | 예 | 예 |
PathAngleArc | 예 | 예 | 예 |
PathSvg | 예 | 예 | 예 |
PathRectangle | 예 | 예 | 예 |
PathAttribute | 예 | N/A | N/A |
PathPercent | 예 | N/A | N/A |
PathCurve | 예 | 아니요 | 아니요 |
참고: 경로는 시각적 유형이 아니므로 자체적으로 아무것도 표시하지 않습니다. 경로를 그리려면 Shape 을 사용합니다.
PathView, Shape, PathAttribute, PathPercent, PathLine, PathPolyline, PathMove, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg, PathRectangle 를참조하세요 .
속성 문서
closed : bool |
이 속성은 경로의 시작과 끝이 동일한지 여부를 보유합니다.
pathElements : list<PathElement> |
이 속성은 경로를 구성하는 객체를 보유합니다.
경로에는 다음과 같은 경로 개체가 포함될 수 있습니다:
- PathLine - 지정된 위치에 대한 직선
- PathPolyline - 좌표 목록으로 지정된 폴리라인.
- PathMultiline - 좌표 목록으로 지정된 폴리라인 목록.
- PathQuad - 제어점이 있는 지정된 위치에 대한 이차 베지어 곡선.
- PathCubic - 두 개의 제어점을 가진 주어진 위치에 대한 3차 베지어 곡선.
- PathArc - 반지름을 갖는 주어진 위치에 대한 호.
- PathAngleArc - 중심점, 반지름, 각도로 지정된 호입니다.
- PathSvg - SVG 경로 데이터 문자열로 지정된 경로.
- PathRectangle - 지정된 위치와 크기를 가진 사각형
- PathCurve - 캣멀롬 커브의 점.
- PathAttribute - 경로에서 지정된 위치의 속성.
- PathPercent - 경로의 다양한 세그먼트를 따라 항목을 펼치는 방법.
PathView { anchors.fill: parent model: ContactModel {} delegate: delegate path: Path { startX: 120; startY: 100 PathAttribute { name: "iconScale"; value: 1.0 } PathAttribute { name: "iconOpacity"; value: 1.0 } PathQuad { x: 120; y: 25; controlX: 260; controlY: 75 } PathAttribute { name: "iconScale"; value: 0.3 } PathAttribute { name: "iconOpacity"; value: 0.5 } PathQuad { x: 120; y: 100; controlX: -20; controlY: 75 } } }
scale : size |
이 속성은 경로의 배율을 보유합니다. 비등방성 배율을 얻기 위해 scale 의 너비와 높이를 다르게 설정할 수 있습니다.
참고: 이 속성을 설정해도 테두리 너비에는 영향을 주지 않습니다.
이 속성은 QtQuick 2.14에 도입되었습니다.
simplify : bool |
true로 설정하면 경로가 단순화됩니다. 즉, 교차하는 모든 하위 경로를 병합하여 자기 교차점이 없는 경로를 만듭니다. 연속된 평행선도 병합됩니다. 단순화된 경로는 ShapePath.OddEvenFill과 함께 사용하기 위한 것입니다. 베지어 커브 교차점의 수치 불안정성으로 인해 베지어 커브가 선분으로 평탄화될 수 있습니다.
이 프로퍼티는 Qt 6.6에 도입되었습니다.
메서드 문서
현재 경로의 백분율 t 지점을 반환합니다. 인자 t 는 0에서 1 사이여야 합니다.
참고: QPainterPath 의 다른 퍼센트 메서드와 마찬가지로 경로에 곡선이 있는 경우 퍼센트 측정은 길이와 관련하여 선형적이지 않습니다. 곡선이 있는 경우 백분율 인수는 베지어 방정식의 t
매개 변수에 매핑됩니다.
이 메서드는 QtQuick 2.14에 도입되었습니다.
QPainterPath::pointAtPercent()도 참조하십시오 .
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.