이 페이지에서

ProgressBar QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Control

속성

상세 설명

ProgressBar는 작업의 진행 상황을 표시합니다. 값은 정기적으로 업데이트되어야 합니다. 범위는 from 및 to 로 정의되며, 두 값 모두 임의의 값을 가질 수 있습니다.

ProgressBar {
    value: 0.5
}

ProgressBar는 또한 특수한 ‘ indeterminate ’ 모드를 지원하며, 이는 예를 들어 다운로드 중인 항목의 크기를 파악할 수 없거나 네트워크 연결 끊김으로 인해 다운로드 진행 상황이 중단된 경우에 유용합니다.

ProgressBar {
    indeterminate: true
}

불확정 모드는 ' BusyIndicator'와 유사합니다. 둘 다 백그라운드 활동을 표시하는 데 사용할 수 있습니다. 주요 차이점은 시각적인 측면이며, ProgressBar는 (진행 상황을 파악할 수 있는 경우) 구체적인 진행량도 표시할 수 있습니다. 이러한 시각적 차이 때문에, 불확정 진행률 표시줄과 바쁜 상태 표시기는 사용자 인터페이스 내에서 서로 다른 위치에 배치됩니다. 불확정 진행률 표시줄이 주로 사용되는 위치:

  • 콘텐츠 하단의 ToolBar
  • xml-ph-0000@deepl.internal 내 콘텐츠의 인라인 Page
  • ItemDelegate 내에서 특정 항목의 진행 상황을 표시하기 위해

ProgressBar, BusyIndicator 및 Indicator 컨트롤사용자 정의항목도 참조하십시오 .

속성 설명서

from : real

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

to 및 value도 참조하십시오 .

indeterminate : bool

이 속성은 진행률 표시줄이 ‘불확정 모드’인 경우에도 적용됩니다. 불확정 모드에 있는 진행률 표시줄은 작업이 진행 중임을 나타내지만, 진행률이 얼마나 진행되었는지는 표시하지 않습니다.

position : real [read-only]

이 속성은 진행 상황의 논리적 위치를 나타냅니다.

이 위치는 0.0 - 1.0 범위의 값에 대한 비율로 표현됩니다. 진행 상황을 시각화하려면 대신 오른쪽에서 왼쪽으로 읽는 방향을 지원하는 visualPosition 를 사용해야 합니다.

value 및 visualPosition도 참조하십시오 .

to : real

이 속성은 진행 상황의 최종 값을 저장합니다. 기본값은 1.0 입니다.

from 및 value도 참조하십시오 .

value : real

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

from, to 및 position도 참조하십시오 .

visualPosition : real [read-only]

이 속성은 진행 바의 시각적 위치를 나타냅니다.

위치는 0.0 - 1.0 범위의 값에 대한 비율로 표현됩니다. 컨트롤이 mirrored 상태일 때, visuaPosition 는 1.0 - position 와 같습니다. 이를 통해 visualPosition 는 오른쪽에서 왼쪽으로 읽는 환경을 고려하여 진행 상황을 시각화하는 데 적합합니다.

position 및 value도 참조하십시오 .

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