다음을 통해 공유

ScrollBar.Value 속성

  • 아티클

scroll bar 컨트롤에 있는 스크롤 상자의 현재 위치를 나타내는 숫자 값을 가져오거나 설정합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
<BindableAttribute(True)> _
Public Property Value As Integer
‘사용 방법
Dim instance As ScrollBar
Dim value As Integer

value = instance.Value

instance.Value = value

[BindableAttribute(true)] 
public int Value { get; set; }

[BindableAttribute(true)] 
public:
property int Value {
    int get ();
    void set (int value);
}

/** @property */
public int get_Value ()

/** @property */
public void set_Value (int value)

public function get Value () : int

public function set Value (value : int)

속성 값

Minimum에서 Maximum 범위 사이의 숫자 값으로, 기본값은 0입니다.

예외

예외 형식 조건

ArgumentOutOfRangeException

할당된 값이 Minimum 속성 값보다 작은 경우

- 또는 -

할당된 값이 Maximum 속성 값보다 큰 경우

예제

다음 코드 예제에서는 파생 클래스인 VScrollBar 및 HScrollBar를 사용하고 해당 공용 속성 중 일부를 설정합니다. Maximum 속성은 부모인 PictureBox에 할당된 Image의 Height 또는 Width와 동일하게 설정됩니다. LargeChange 속성은 스크롤 막대의 높이 또는 너비를 뺀 그림 상자의 크기와 동일하게 설정됩니다. SmallChange 속성이 5로 나눈 LargeChange 속성 값으로 설정됩니다. 마지막으로 두 스크롤 막대에 대한 Value 속성 값이 0으로 설정됩니다. 따라서 가로 및 세로 스크롤 막대가 Image의 왼쪽 위 모퉁이에 있는 그림 상자에 표시됩니다. 스크롤 막대는 이미지의 끝을 지나 스크롤하지 않습니다. LargeChange 스크롤이 수행되면 이미지는 그림 상자에 표시된 해당 영역과 동일한 거리를 이동합니다. LargeChange 값으로 한 번 스크롤하는 거리는 SmallChange 값으로 다섯 번 스크롤하는 거리와 같습니다. 이 코드는 Form에 PictureBox, HScrollBar, VScrollBar 및 Image가 모두 만들어져 있다고 가정합니다. 또한 System.Drawing 네임스페이스에 대한 참조가 추가되었다고 가정합니다. 이 예제를 확장할 수 있는 추가 코드에 대해서는 ScrollBar 클래스 개요를 참조하십시오.

Public Sub SetScrollBarValues()
   ' Set the Maximum, Minimum, LargeChange and SmallChange properties.
   Me.vScrollBar1.Minimum = 0
   Me.hScrollBar1.Minimum = 0
   
   ' If the offset does not make the Maximum less than zero, set its value.
   If Me.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width > 0 Then
      Me.hScrollBar1.Maximum = Me.pictureBox1.Image.Size.Width - _
        pictureBox1.ClientSize.Width
   End If
   ' If the VScrollBar is visible, adjust the Maximum of the 
   ' HSCrollBar to account for the width of the VScrollBar.
   If Me.vScrollBar1.Visible Then
      Me.hScrollBar1.Maximum += Me.vScrollBar1.Width
   End If
   Me.hScrollBar1.LargeChange = Me.hScrollBar1.Maximum / 10
   Me.hScrollBar1.SmallChange = Me.hScrollBar1.Maximum / 20
   ' Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   Me.hScrollBar1.Maximum += Me.hScrollBar1.LargeChange
         
   ' If the offset does not make the Maximum less than zero, set its value.
   If Me.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height > 0 Then
      Me.vScrollBar1.Maximum = Me.pictureBox1.Image.Size.Height - _
        pictureBox1.ClientSize.Height
   End If
   ' If the HScrollBar is visible, adjust the Maximum of the 
   ' VSCrollBar to account for the width of the HScrollBar.
   If Me.hScrollBar1.Visible Then
      Me.vScrollBar1.Maximum += Me.hScrollBar1.Height
   End If
   Me.vScrollBar1.LargeChange = Me.vScrollBar1.Maximum / 10
   Me.vScrollBar1.SmallChange = Me.vScrollBar1.Maximum / 20
   ' Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   Me.vScrollBar1.Maximum += Me.vScrollBar1.LargeChange
End Sub

public void SetScrollBarValues() 
{
   // Set the Maximum, Minimum, LargeChange and SmallChange properties.
   this.vScrollBar1.Minimum = 0;
   this.hScrollBar1.Minimum = 0;
   // If the offset does not make the Maximum less than zero, set its value. 
   if( (this.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width) > 0)
   {
      this.hScrollBar1.Maximum = this.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width;
   }
   /* If the VScrollBar is visible, adjust the Maximum of the 
      HSCrollBar to account for the width of the VScrollBar. */
   if(this.vScrollBar1.Visible)
   {
      this.hScrollBar1.Maximum += this.vScrollBar1.Width;
   }
   this.hScrollBar1.LargeChange = this.hScrollBar1.Maximum / 10;
   this.hScrollBar1.SmallChange = this.hScrollBar1.Maximum / 20;
   // Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   this.hScrollBar1.Maximum += this.hScrollBar1.LargeChange;
     
   // If the offset does not make the Maximum less than zero, set its value.    
   if( (this.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height) > 0)
   {
      this.vScrollBar1.Maximum = this.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height;
   }
   /* If the HScrollBar is visible, adjust the Maximum of the 
      VSCrollBar to account for the width of the HScrollBar.*/
   if(this.hScrollBar1.Visible)
   {
      this.vScrollBar1.Maximum += this.hScrollBar1.Height;
   }
   this.vScrollBar1.LargeChange = this.vScrollBar1.Maximum / 10;
   this.vScrollBar1.SmallChange = this.vScrollBar1.Maximum / 20;
   // Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   this.vScrollBar1.Maximum += this.vScrollBar1.LargeChange;
}

void SetScrollBarValues()
{
   // Set the Maximum, Minimum, LargeChange and SmallChange properties.
   this->vScrollBar1->Minimum = 0;
   this->hScrollBar1->Minimum = 0;

   // If the offset does not make the Maximum less than zero, set its value. 
   if ( (this->pictureBox1->Image->Size.Width - pictureBox1->ClientSize.Width) > 0 )
   {
      this->hScrollBar1->Maximum = this->pictureBox1->Image->Size.Width - pictureBox1->ClientSize.Width;
   }

   /* If the VScrollBar is visible, adjust the Maximum of the 
         HSCrollBar to account for the width of the VScrollBar. */
   if ( this->vScrollBar1->Visible )
   {
      this->hScrollBar1->Maximum += this->vScrollBar1->Width;
   }

   this->hScrollBar1->LargeChange = this->hScrollBar1->Maximum / 10;
   this->hScrollBar1->SmallChange = this->hScrollBar1->Maximum / 20;

   // Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   this->hScrollBar1->Maximum += this->hScrollBar1->LargeChange;

   // If the offset does not make the Maximum less than zero, set its value.    
   if ( (this->pictureBox1->Image->Size.Height - pictureBox1->ClientSize.Height) > 0 )
   {
      this->vScrollBar1->Maximum = this->pictureBox1->Image->Size.Height - pictureBox1->ClientSize.Height;
   }

   /* If the HScrollBar is visible, adjust the Maximum of the 
         VSCrollBar to account for the width of the HScrollBar.*/
   if ( this->hScrollBar1->Visible )
   {
      this->vScrollBar1->Maximum += this->hScrollBar1->Height;
   }

   this->vScrollBar1->LargeChange = this->vScrollBar1->Maximum / 10;
   this->vScrollBar1->SmallChange = this->vScrollBar1->Maximum / 20;
   
   // Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   this->vScrollBar1->Maximum += this->vScrollBar1->LargeChange;
}

public void SetScrollBarValues()
{
    // Set the Maximum, Minimum, LargeChange and SmallChange properties.
    this.vScrollBar1.set_Minimum(0);
    this.hScrollBar1.set_Minimum(0);

    // If the offset does not make the Maximum less than zero, 
    // set its value. 
    if (this.pictureBox1.get_Image().get_Size().get_Width() 
        - pictureBox1.get_ClientSize().get_Width() > 0) {
            this.hScrollBar1.set_Maximum(
                this.pictureBox1.get_Image().get_Size().get_Width() 
                - pictureBox1.get_ClientSize().get_Width());
    }

    /* If the VScrollBar is visible, adjust the Maximum of the 
       HSCrollBar to account for the width of the VScrollBar. 
     */
    if (this.vScrollBar1.get_Visible()) {
        this.hScrollBar1.set_Maximum(
            this.hScrollBar1.get_Maximum() + this.vScrollBar1.get_Width());
    }

    this.hScrollBar1.set_LargeChange(this.hScrollBar1.get_Maximum() / 10);
    this.hScrollBar1.set_SmallChange(this.hScrollBar1.get_Maximum() / 20);

    // Adjust the Maximum value to make the raw Maximum value attainable 
    // by user interaction.
    this.hScrollBar1.set_Maximum(
        this.hScrollBar1.get_Maximum() 
        + this.hScrollBar1.get_LargeChange());

    // If the offset does not make the Maximum less than zero, 
    // set its value.    
    if (this.pictureBox1.get_Image().get_Size().get_Height() 
        - pictureBox1.get_ClientSize().get_Height() > 0) {
            this.vScrollBar1.set_Maximum(
                this.pictureBox1.get_Image().get_Size().get_Height() 
                - pictureBox1.get_ClientSize().get_Height());
    }

    /* If the HScrollBar is visible, adjust the Maximum of the 
       VSCrollBar to account for the width of the HScrollBar.
     */
    if (this.hScrollBar1.get_Visible()) {
        this.vScrollBar1.set_Maximum(this.vScrollBar1.get_Maximum() 
            + this.hScrollBar1.get_Height());
    }

    this.vScrollBar1.set_LargeChange(this.vScrollBar1.get_Maximum() / 10);
    this.vScrollBar1.set_SmallChange(this.vScrollBar1.get_Maximum() / 20);

    // Adjust the Maximum value to make the raw Maximum value attainable 
    // by user interaction.
    this.vScrollBar1.set_Maximum(
        this.vScrollBar1.get_Maximum() 
        + this.vScrollBar1.get_LargeChange());
} //SetScrollBarValues

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

ScrollBar 클래스
ScrollBar 멤버
System.Windows.Forms 네임스페이스