ProgressBar.Maximum ProgressBar.Maximum ProgressBar.Maximum ProgressBar.Maximum Property

정의

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

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

속성 값

범위의 최대값입니다.The maximum value of the range. 기본값은 100입니다.The default is 100.

예외

지정된 값이 0보다 작은 경우The value specified 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. 코드 또한 사용 하 여는 Step 속성을 PerformStep 값이 증가 하는 방법은 ProgressBar 파일이 복사 되는 대로.The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. 이 예제를 실행 하려면를 ProgressBar 라는 컨트롤 pBar1 내에서 만들어지는 Form 메서드는 및 이라는 생성 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 upper limit of the Value property. 때 값을 Maximum 속성이 변경 되는 ProgressBar 컨트롤이 컨트롤의 새 범위에 맞게 다시 그려집니다.When the value of the Maximum property is changed, the ProgressBar control is redrawn to reflect the new range of the control. 때의 값을 Value 속성의 값은 Maximum 속성, 진행률 표시줄을 완전히으로 채워집니다.When the value of the Value property is equal to the value of the Maximum property, the progress bar is completely filled.

값을 지정 하려면이 속성을 사용할 수는 Value 속성을 설정 해야 (설정 하 여는 Value 속성이 나 사용 하 여를 Increment 또는 PerformStep 메서드)는 작업이 완료 되었음을 나타내기 위해.You can use this property to specify a value to which the Value property must be set (by setting the Value property or using the Increment or PerformStep methods) to indicate that an operation is complete. 예를 들어,의 값을 설정할 수 있습니다는 Maximum 총 파일 복사 작업에서 파일에는 속성입니다.For example, you can set the value of the Maximum property to the total number of files in a file copy operation. 파일을 복사 될 때마다는 Value 속성 총 파일 복사는 때까지 1 씩 늘릴 수 있습니다.Each time a file is copied, the Value property can be increased by 1 until the total number of files is copied. 이때 진행률 표시줄 완전히 채울 수는 있습니다.At that point, the progress bar would be completely filled.

적용 대상

추가 정보