다음을 통해 공유

ProgressBar 컨트롤 개요(Windows Forms)

  • 아티클

중요

ToolStripProgressBar 컨트롤은 ProgressBar 컨트롤을 대체하고 여기에 다른 기능을 추가하여 새로 도입된 컨트롤이지만 이전 버전과의 호환성 및 이후 사용 가능성을 고려하여 ProgressBar 컨트롤을 계속 유지하도록 선택할 수 있습니다.

Windows Forms ProgressBar 컨트롤은 가로 막대에 정렬된 적절한 수의 사각형을 표시하여 프로세스의 진행률을 나타냅니다. 프로세스가 완료되면 막대가 채워집니다. 진행률 표시줄은 일반적으로 프로세스 완료까지 기다릴 시간을 사용자에게 제공하는 데 사용됩니다(예: 큰 파일이 로딩 중인 경우).

참고

ProgressBar 컨트롤만 양식에서 가로 방향일 수 있습니다.

주요 속성 및 메서드

ProgressBar 컨트롤의 핵심 속성은 Value, Minimum 및 Maximum입니다. Minimum 및 Maximum 속성은 진행률 표시줄에 표시할 수 있는 최댓값과 최솟값을 설정합니다. Value 속성은 작업 완료를 향해 이루어진 진행률을 나타냅니다. 컨트롤에 표시된 표시줄은 블록으로 구성되므로 ProgressBar 컨트롤에 의해 표시된 값은 Value 속성의 현재 값의 근사치일 뿐입니다. ProgressBar 컨트롤의 크기를 기준으로 Value 속성은 다음 블록을 표시할 시간을 결정합니다.

현재 진행률 값을 업데이트하는 가장 일반적인 방법은 Value 속성을 설정하는 코드를 작성하는 것입니다. 큰 파일을 로드하는 예제라면 최댓값을 파일 크기(킬로바이트 단위)로 설정할 수 있습니다. 예를 들어 Maximum 속성이 100으로 설정되고, Minimum 속성이 10으로 설정되고, Value 속성이 50으로 설정된다면 5개의 사각형이 표시됩니다. 이것은 표시할 수 있는 수의 절반입니다.

그러나 Value 속성을 직접 설정하는 것 외에도 ProgressBar 컨트롤에서 표시하는 값을 수정하는 다른 방법이 있습니다. Step 속성을 사용하여 Value 속성을 증분할 값을 지정할 수 있습니다. 그런 다음 PerformStep 메서드를 호출하면 값이 증가합니다. 증가값을 다르게 하려면 Increment 메서드를 사용하고 Value 속성을 증가시킬 값을 지정합니다.

현재 작업에 대해 사용자에게 그래픽으로 알리는 또 다른 컨트롤은 StatusBar 컨트롤입니다.

중요

StatusStrip 및 ToolStripStatusLabel 컨트롤은 StatusBar 및 StatusBarPanel 컨트롤을 대체하고 새로운 기능을 추가한 것이지만 이전 버전과의 호환성 및 앞으로의 사용 가능성을 고려하여 StatusBar 및 StatusBarPanel 컨트롤을 유지하도록 선택할 수 있습니다.

참고 항목