ProgressBar QML Type

작업 진행률을 나타냅니다. 더 보기...

Import Statement: import QtQuick.Controls
Inherits:

Control

속성

상세 설명

진행률 표시줄은 작업의 진행률을 나타냅니다. 이 값은 정기적으로 업데이트해야 합니다. 범위는 fromto 으로 정의되며, 두 값 모두 임의의 값을 포함할 수 있습니다.

ProgressBar {
    value: 0.5
}

ProgressBar는 다운로드 중인 항목의 크기를 확인할 수 없거나 네트워크 연결이 끊어져 다운로드 진행이 중단된 경우 등에 유용한 특수 indeterminate 모드도 지원합니다.

ProgressBar {
    indeterminate: true
}

불확정 모드는 BusyIndicator 과 유사하며, 둘 다 백그라운드 활동을 표시하는 데 사용할 수 있습니다. 가장 큰 차이점은 시각적이라는 점이며, 진행률 표시줄은 구체적인 진행률(확인 가능한 경우)도 표시할 수 있다는 점입니다. 시각적 차이로 인해 불확정 진행률 표시줄과 사용 중 표시기는 사용자 인터페이스에서 서로 다른 위치에 적합합니다. 불확정 진행률 표시줄의 일반적인 위치는 다음과 같습니다:

  • 의 하단 ToolBar
  • 의 콘텐츠 내 인라인 Page
  • ItemDelegate 에서 특정 항목의 진행률을 표시하는 인라인 하단

진행률 표시줄 사용자 지정하기, BusyIndicator표시기 컨트롤도참조하세요 .

속성 문서

from : real

이 속성은 진행률의 시작 값을 보유합니다. 기본값은 0.0 입니다.

tovalue도 참조하세요 .


indeterminate : bool

이 속성은 진행률 표시줄이 불확정 모드인지 여부를 저장합니다. 불확정 모드의 진행률 표시줄은 작업이 진행 중임을 표시하지만 얼마나 진행되었는지는 표시하지 않습니다.


position : real [read-only]

이 속성은 진행률의 논리적 위치를 유지합니다.

위치는 0.0 - 1.0 범위에서 값의 일부분으로 표시됩니다. 진행률을 시각화하려면 오른쪽에서 왼쪽으로 인식되는 visualPosition 을 대신 사용해야 합니다.

valuevisualPosition참조하세요 .


to : real

이 속성은 진행률의 최종 값을 보유합니다. 기본값은 1.0 입니다.

fromvalue도 참조 하세요.


value : real

이 속성은 진행률 값을 보유합니다. 기본값은 0.0 입니다.

from, to, position도 참조 하세요.


visualPosition : real [read-only]

이 속성은 진행률의 시각적 위치를 저장합니다.

위치는 0.0 - 1.0 범위에서 값의 분수로 표시됩니다. 컨트롤이 mirrored 인 경우 visuaPosition1.0 - position 과 같습니다. 따라서 오른쪽에서 왼쪽 지원을 고려하여 진행률을 시각화하는 데 visualPosition 이 적합합니다.

positionvalue참조하세요 .


© 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.