ScrollBar.LargeChange Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia wartość do dodania lub odejmowania od Value właściwości po przeniesieniu pola przewijania na dużą odległość.

public:
 property int LargeChange { int get(); void set(int value); };

public int LargeChange { get; set; }

member this.LargeChange : int with get, set

Public Property LargeChange As Integer

Wartość właściwości

Int32

Wartość liczbowa. Wartość domyślna to 10.

Wyjątki

ArgumentOutOfRangeException

Przypisana wartość jest mniejsza niż 0.

Przykłady

W poniższym przykładzie założono, że utworzono element Form, dodany PictureBox do Formelementu , i dodano poziomą i pionową VScrollBar HScrollBar do elementu PictureBox. Ten przykład kodu jest częścią większego przykładu podanego ScrollBar na potrzeby przeglądu klasy.

W tym przykładzie LargeChange właściwość jest ustawiana względem rozmiaru PictureBoxobiektu .

Aby uruchomić ten przykład, należy dodać odwołania do System.Drawing przestrzeni nazw i System.Windows.Forms .

Uwaga

Aby uzyskać instrukcje dotyczące uruchamiania tego przykładu w Visual Studio, zobacz Instrukcje: kompilowanie i uruchamianie kompletnego przykładu kodu Windows Forms przy użyciu Visual Studio.

public void SetScrollBarValues()
{
    //Set the following scrollbar properties:

    //Minimum: Set to 0

    //SmallChange and LargeChange: Per UI guidelines, these must be set
    //    relative to the size of the view that the user sees, not to
    //    the total size including the unseen part.  In this example,
    //    these must be set relative to the picture box, not to the image.

    //Maximum: Calculate in steps:
    //Step 1: The maximum to scroll is the size of the unseen part.
    //Step 2: Add the size of visible scrollbars if necessary.
    //Step 3: Add an adjustment factor of ScrollBar.LargeChange.

    //Configure the horizontal scrollbar
    //---------------------------------------------
    if (this.hScrollBar1.Visible)
    {
        this.hScrollBar1.Minimum = 0;
        this.hScrollBar1.SmallChange = this.pictureBox1.Width / 20;
        this.hScrollBar1.LargeChange = this.pictureBox1.Width / 10;

        this.hScrollBar1.Maximum = this.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width;  //step 1

        if (this.vScrollBar1.Visible) //step 2
        {
            this.hScrollBar1.Maximum += this.vScrollBar1.Width;
        }

        this.hScrollBar1.Maximum += this.hScrollBar1.LargeChange; //step 3
    }

    //Configure the vertical scrollbar
    //---------------------------------------------
    if (this.vScrollBar1.Visible)
    {
        this.vScrollBar1.Minimum = 0;
        this.vScrollBar1.SmallChange = this.pictureBox1.Height / 20;
        this.vScrollBar1.LargeChange = this.pictureBox1.Height / 10;

        this.vScrollBar1.Maximum = this.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height; //step 1

        if (this.hScrollBar1.Visible) //step 2
        {
            this.vScrollBar1.Maximum += this.hScrollBar1.Height;
        }

        this.vScrollBar1.Maximum += this.vScrollBar1.LargeChange; //step 3
    }
}

Public Sub SetScrollBarValues()

    'Set the following scrollbar properties:

    'Minimum: Set to 0

    'SmallChange and LargeChange: Per UI guidelines, these must be set
    '    relative to the size of the view that the user sees, not to
    '    the total size including the unseen part.  In this example,
    '    these must be set relative to the picture box, not to the image.

    'Maximum: Calculate in steps:
    'Step 1: The maximum to scroll is the size of the unseen part.
    'Step 2: Add the size of visible scrollbars if necessary.
    'Step 3: Add an adjustment factor of ScrollBar.LargeChange.


    'Configure the horizontal scrollbar
    '---------------------------------------------
    If (Me.hScrollBar1.Visible) Then

        Me.hScrollBar1.Minimum = 0
        Me.hScrollBar1.SmallChange = CInt(Me.pictureBox1.Width / 20)
        Me.hScrollBar1.LargeChange = CInt(Me.pictureBox1.Width / 10)

        Me.hScrollBar1.Maximum = Me.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width  'step 1

        If (Me.vScrollBar1.Visible) Then 'step 2

            Me.hScrollBar1.Maximum += Me.vScrollBar1.Width
        End If

        Me.hScrollBar1.Maximum += Me.hScrollBar1.LargeChange 'step 3
    End If

    'Configure the vertical scrollbar
    '---------------------------------------------
    If (Me.vScrollBar1.Visible) Then

        Me.vScrollBar1.Minimum = 0
        Me.vScrollBar1.SmallChange = CInt(Me.pictureBox1.Height / 20)
        Me.vScrollBar1.LargeChange = CInt(Me.pictureBox1.Height / 10)

        Me.vScrollBar1.Maximum = Me.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height 'step 1

        If (Me.hScrollBar1.Visible) Then 'step 2

            Me.vScrollBar1.Maximum += Me.hScrollBar1.Height
        End If

        Me.vScrollBar1.Maximum += Me.vScrollBar1.LargeChange 'step 3
    End If
 End Sub

Uwagi

Gdy użytkownik kliknie ścieżkę paska przewijania po obu stronach pola przewijania, Value właściwość zmienia się zgodnie z wartością ustawioną LargeChange we właściwości.

Uwaga

Możesz obsługiwać zdarzenia naciśnięcia klawiszy, aby po naciśnięciu przez użytkownika klawisza PAGE UP lub PAGE DOWN pole przewijania przesuwało się.

Wytyczne interfejsu użytkownika sugerują, że SmallChange właściwości i LargeChange są ustawione względem rozmiaru widoku, który widzi użytkownik, a nie do całkowitego rozmiaru, w tym niezaużytowanej części. Jeśli na przykład masz pole obrazu z paskami przewijania wyświetlającym duży obraz, SmallChange właściwości i LargeChange powinny być ustawione względem rozmiaru pola obrazu, a nie rozmiaru obrazu.

Zobacz też

• SmallChange