ProgressBar.Minimum 속성

정의

컨트롤 범위의 최소값을 가져오거나 설정합니다.Gets or sets the minimum value of the range of the control.

public:
 property int Minimum { int get(); void set(int value); };
public int Minimum { get; set; }
member this.Minimum : int with get, set
Public Property Minimum As Integer

속성 값

범위의 최소값입니다.The minimum value of the range. 기본값은 0입니다.The default is 0.

예외

속성에 대해 지정 된 값이 0 보다 작은 경우The value specified for the property is less than 0.

예제

다음 코드 예제에서는 ProgressBar 컨트롤을 사용 하 여 파일 복사 작업의 진행률을 표시 합니다.The following code example uses a ProgressBar control to display the progress of a file copy operation. 이 예에서는 MinimumMaximum 속성을 사용 하 여 복사할 파일 수에 해당 하는 ProgressBar 범위를 지정 합니다.The example uses the Minimum and Maximum properties to specify a range for the ProgressBar that is equivalent to the number of files to copy. 또한이 코드는 PerformStep 메서드와 함께 Step 속성을 사용 하 여 파일이 복사 될 때 ProgressBar 값을 증가 시킵니다.The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. 이 예제를 사용 하려면 Form내에 생성 된 pBar1 이라는 ProgressBar 컨트롤이 만들어지고 파일 복사 작업을 수행 하는 CopyFile (파일 복사 작업이 성공적으로 완료 되었음을 나타내는 부울 값을 반환 함)가 생성 되어 있어야 합니다.This example requires that you have a ProgressBar control created called pBar1 that is created within a Form, and that there is a method created called CopyFile (that returns a Boolean value indicating the file copy operation was completed successfully) that performs the file copy operation. 이 코드를 사용 하려면 복사할 파일을 포함 하는 문자열 배열이 만들어지고 예제에 정의 된 CopyWithProgress 메서드에 전달 되어야 하며, Form의 다른 메서드나 이벤트에서 메서드가 호출 되어야 합니다.The code also requires that an array of strings containing the files to copy is created and passed to the CopyWithProgress method defined in the example, and that the method is called from another method or event in the Form.

private:
   void CopyWithProgress( array<String^>^filenames )
   {
      // Display the ProgressBar control.
      pBar1->Visible = true;

      // Set Minimum to 1 to represent the first file being copied.
      pBar1->Minimum = 1;

      // Set Maximum to the total number of files to copy.
      pBar1->Maximum = filenames->Length;

      // Set the initial value of the ProgressBar.
      pBar1->Value = 1;

      // Set the Step property to a value of 1 to represent each file being copied.
      pBar1->Step = 1;

      // Loop through all files to copy.
      for ( int x = 1; x <= filenames->Length; x++ )
      {
         // Copy the file and increment the ProgressBar if successful.
         if ( CopyFile( filenames[ x - 1 ] ) == true )
         {
            // Perform the increment on the ProgressBar.
            pBar1->PerformStep();
         }
      }
   }
private void CopyWithProgress(string[] filenames)
{
    // Display the ProgressBar control.
    pBar1.Visible = true;
    // Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1;
    // Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length;
    // Set the initial value of the ProgressBar.
    pBar1.Value = 1;
    // Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1;
    
    // Loop through all files to copy.
    for (int x = 1; x <= filenames.Length; x++)
    {
        // Copy the file and increment the ProgressBar if successful.
        if(CopyFile(filenames[x-1]) == true)
        {
            // Perform the increment on the ProgressBar.
            pBar1.PerformStep();
        }
    }
}
Private Sub CopyWithProgress(ByVal ParamArray filenames As String())
    ' Display the ProgressBar control.
    pBar1.Visible = True
    ' Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1
    ' Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length
    ' Set the initial value of the ProgressBar.
    pBar1.Value = 1
    ' Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1

    ' Loop through all files to copy.
    Dim x As Integer
    for x = 1 To filenames.Length - 1
        ' Copy the file and increment the ProgressBar if successful.
        If CopyFile(filenames(x - 1)) = True Then
            ' Perform the increment on the ProgressBar.
            pBar1.PerformStep()
        End If
    Next x
End Sub

설명

이 속성의 하 한 지정 된 Value 속성입니다.This property specifies the lower limit of the Value property. 때 값을 Minimum 속성이 변경 되는 ProgressBar 컨트롤이 컨트롤의 새 범위에 맞게 다시 그려집니다.When the value of the Minimum property is changed, the ProgressBar control is redrawn to reflect the new range of the control. 때의 값을 Value 속성의 값은 Minimum 속성인 진행률 표시줄 비어 있습니다. 합니다.When the value of the Value property is equal to the value of the Minimum property, the progress bar is empty. 진행률 표시줄의 값을 변경 하려면 사용 하 여는 Step 속성을를 PerformStep 메서드를 사용 하 여는 Increment 메서드를의 값을 가져오거나 설정 합니다 Value 속성을 직접.To change the value of the progress bar, use the Step property with the PerformStep method, use the Increment method, or set the value of the Value property directly.

적용 대상

추가 정보