Прочитать на английском

Поделиться через


ScrollBar.ValueChanged Событие

Определение

Происходит при изменении свойства Value либо в результате события Scroll, либо программно.

public event EventHandler ValueChanged;
public event EventHandler? ValueChanged;

Тип события

Примеры

В следующем примере кода используется производный класс VScrollBar. Создаются обработчики Scroll событий и ValueChanged . В этом коде предполагается, что Label и Button были созданы в форме, а кнопка имеет обработчик Click события. При нажатии кнопки Value свойство полосы прокрутки корректируется в коде. Метка отобразит текущее Value значение свойства и событие, которое его изменило. Вы заметите, что при изменении значения прокрутки событием кнопки ClickValueChanged вызывается только событие . В отличие от этого, когда полоса прокрутки прокручивается вручную, Scroll событие вызывается сразу после ValueChanged события.

Примечание

Инструкции по выполнению этого примера в Visual Studio см. в разделе Практическое руководство. Компиляция и запуск полного кода Windows Forms пример с помощью Visual Studio.

private void AddMyScrollEventHandlers()
 {
    // Create and initialize a VScrollBar.
    VScrollBar vScrollBar1 = new VScrollBar();
 
    // Add event handlers for the OnScroll and OnValueChanged events.
    vScrollBar1.Scroll += new ScrollEventHandler(
       this.vScrollBar1_Scroll);
    vScrollBar1.ValueChanged += new EventHandler(
       this.vScrollBar1_ValueChanged); 
 }
 
 // Create the ValueChanged event handler.
 private void vScrollBar1_ValueChanged(Object sender, 
                                       EventArgs e)
 {
     // Display the new value in the label.
     label1.Text = "vScrollBar Value:(OnValueChanged Event) " + vScrollBar1.Value.ToString();
 }
 
 // Create the Scroll event handler.
 private void vScrollBar1_Scroll(Object sender, 
                                 ScrollEventArgs e)
 {
     // Display the new value in the label.
     label1.Text = "VScrollBar Value:(OnScroll Event) " + e.NewValue.ToString();
 }
 
 private void button1_Click(Object sender, 
                           EventArgs e)
 {
    // Add 40 to the Value property if it will not exceed the Maximum value.
    if (vScrollBar1.Value + 40 < vScrollBar1.Maximum)
    {
        vScrollBar1.Value = vScrollBar1.Value + 40;
    }
 }

Комментарии

Дополнительные сведения об обработке событий см. в разделе Обработка и создание событий.

Применяется к

Продукт Версии
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

См. также раздел