Scroll Bar. Scroll Событие

Определение

Происходит при перемещении ползунка с помощью мыши или клавиатуры. Occurs when the scroll box has been moved by either a mouse or keyboard action.

Тип события

Примеры

В следующем примере изображение прокручивается в рамке изображения. The following example scrolls an image in a picture box. Он использует Value полосу прокрутки для перерисовки новой части изображения при прокрутке пользователем. It uses the Value of the scrollbar to redraw a new part of the image whenever the user scrolls. Этот пример кода является частью большого примера, приведенного в разделе ScrollBar Общие сведения о классе. This code example is part of a larger example provided for the ScrollBar class overview.

Инструкции по запуску этого примера в Visual Studio см. в разделе как скомпилировать и запустить полный пример кода Windows Forms с помощью Visual Studio. For instructions about how to run this example in Visual Studio, see How to: Compile and Run a Complete Windows Forms Code Example Using Visual Studio.

В следующем примере кода используется производный класс VScrollBar . The following code example uses the derived class VScrollBar. Создаются обработчики событий Scroll для ValueChanged событий и. Event handlers for the Scroll and ValueChanged events are created. В этом коде предполагается, что объект Label и был Button создан в форме, а у кнопки есть обработчик событий для Click события. This code assumes that a Label and Button have been created on a form and that the button has an event handler for the Click event. При нажатии кнопки Value свойство полосы прокрутки корректируется в коде. When the button is clicked, the Value property of the scroll bar is adjusted in code. Метка будет отображать текущее значение Value Свойства и событие, которое его изменило. The label will display the current value of the Value property and the event that changed it. Обратите внимание, что когда значение прокрутки изменяется Click событием кнопки, ValueChanged возникает только событие. You will notice that when the scroll value is changed by the button’s Click event, only the ValueChanged event is raised. Напротив, когда полоса прокрутки прокручивается вручную, Scroll событие возникает сразу после ValueChanged события. In contrast, when the scroll bar is scrolled manually, the Scroll event is raised immediately after the ValueChanged event.

Комментарии

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий. For more information about how to handle events, see Handling and Raising Events.

Track Bar. Scroll Событие

Определение

Происходит, когда мышью или клавиатурой вызывается перемещение ползунка. Occurs when either a mouse or keyboard action moves the scroll box.

Тип события

Примеры

В следующем примере кода показано, как реализовать Scroll событие для изменения меток сведений в форме на основе прокрутки ползунка на панели мониторинга. The following code example shows how to implement the Scroll event to modify information labels on a form, based on the scrolling of the scroll box on a track bar. Для примера требуется, чтобы на Form нем было размещено три полосы прокрутки и три метки. The example requires a Form with three track bars and three labels placed on it.

В следующем примере кода выводится форма, содержащая TrackBar элемент управления и TextBox элемент управления. The following code example displays a form that contains a TrackBar control and a TextBox control. В примере показано задание Maximum свойств, TickFrequency , LargeChange и SmallChange и обработка Scroll события. The example demonstrates setting the Maximum, TickFrequency, LargeChange, and SmallChange properties and handling the Scroll event. TextBoxСодержимое обновляется до Value значения свойства при Scroll возникновении события. The TextBox contents are updated to the Value property value when the Scroll event occurs.

Комментарии

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий. For more information about handling events, see Handling and Raising Events.

Data Grid View. Scroll Событие

Определение

Происходит, когда пользователь прокручивает содержимое элемента управления. Occurs when the user scrolls through the control contents.

Тип события

Примеры

В следующем примере кода показано использование этого элемента. The following code example demonstrates the use of this member. В этом примере обработчик событий сообщает о возникновении Scroll события. In the example, an event handler reports on the occurrence of the Scroll event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке. This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены MessageBox.Show Console.WriteLine или добавления сообщения в многострочный TextBox . To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа DataGridView с именем DataGridView1 . To run the example code, paste it into a project that contains an instance of type DataGridView named DataGridView1 . Затем убедитесь, что обработчик событий связан с Scroll событием. Then ensure that the event handler is associated with the Scroll event.

Комментарии

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий. For more information about how to handle events, see Handling and Raising Events.

Scrollable Control. Scroll Событие

Определение

Происходит в том случае, если пользователь или программа выполняет прокрутку в клиентской области. Occurs when the user or code scrolls through the client area.

Тип события

Примеры

В следующем примере кода показано использование этого элемента. The following code example demonstrates the use of this member. В этом примере обработчик событий сообщает о возникновении Scroll события. In the example, an event handler reports on the occurrence of the Scroll event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке. This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены MessageBox.Show Console.WriteLine или добавления сообщения в многострочный TextBox . To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа, наследуемого от ScrollableControl , например Panel или ContainerControl . To run the example code, paste it into a project that contains an instance of a type that inherits from ScrollableControl, such as a Panel or ContainerControl. Затем присвойте экземпляру имя ScrollableControl1 и убедитесь, что обработчик событий связан с Scroll событием. Then name the instance ScrollableControl1 and ensure that the event handler is associated with the Scroll event.

Комментарии

Это Scroll событие возникает, когда пользователь выполняет прокрутку клиентской области, взаимодействуя с полосами прокрутки, или когда пользователь переходит между элементами управления, а активный элемент управления прокручивается в представление. The Scroll event occurs when the user scrolls through the client area by interacting with the scroll bars, or when the user navigates between controls and the active control scrolls into view. Это Scroll событие также возникает при написании кода, например при задании AutoScrollPosition свойства, которое прокручивается через клиентскую область. The Scroll event also occurs when you write code, such as setting the AutoScrollPosition property, that scrolls through the client area.

ScrollOrientationСвойство в обработчике событий можно использовать для определения ориентации полосы прокрутки для Scroll события. You can use the ScrollOrientation property in your event handler to determine the scroll bar orientation for the Scroll event.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий. For more information about how to handle events, see Handling and Raising Events.

Scroll Event Args Класс

Определение

Предоставляет данные для события Scroll . Provides data for the Scroll event.

Примеры

В следующем примере кода показано использование этого элемента. The following code example demonstrates the use of this member.

Комментарии

Это Scroll событие возникает, когда пользователь изменяет значение полосы прокрутки. The Scroll event occurs when the user changes the value of the scroll bar. Это событие может появиться при различных действиях, например при щелчке стрелки в полосе прокрутки, нажатии клавиши со стрелкой вверх или стрелки вниз или перетаскивании ползунка. This event can result from a variety of actions, such as clicking a scroll bar arrow, pressing the UP ARROW or DOWN ARROW, or dragging the scroll box. ScrollEventArgsУказывает тип произошедшего события прокрутки и новое значение полосы прокрутки. The ScrollEventArgs specifies the type of scroll event that occurred and the new value of the scroll bar. Используйте ScrollOrientation свойство, чтобы определить ориентацию полосы прокрутки для Scroll события. Use the ScrollOrientation property to determine the scroll bar orientation for the Scroll event.

Это Scroll событие возникает для DataGridView ScrollableControl ScrollBar элементов управления,, и DataGrid . The Scroll event occurs for the DataGridView, ScrollableControl, ScrollBar, and DataGrid controls.

Конструкторы

Инициализирует новый экземпляр класса ScrollEventArgs с использованием заданных значений свойств Type и NewValue. Initializes a new instance of the ScrollEventArgs class using the given values for the Type and NewValue properties.

Инициализирует новый экземпляр класса ScrollEventArgs заданными значениями свойств Type, OldValue и NewValue. Initializes a new instance of the ScrollEventArgs class using the given values for the Type, OldValue, and NewValue properties.

Инициализирует новый экземпляр класса ScrollEventArgs с использованием заданных значений свойств Type, OldValue, NewValue иScrollOrientation. Initializes a new instance of the ScrollEventArgs class using the given values for the Type, OldValue, NewValue, and ScrollOrientation properties.

Инициализирует новый экземпляр класса ScrollEventArgs заданными значениями свойств Type, NewValue и ScrollOrientation. Initializes a new instance of the ScrollEventArgs class using the given values for the Type, NewValue, and ScrollOrientation properties.

Свойства

Получает или задает новое значение Value полосы прокрутки. Gets or sets the new Value of the scroll bar.

Получает прежнее значение Value полосы прокрутки. Gets the old Value of the scroll bar.

Получает ориентацию полосы прокрутки, вызвавшей событие Scroll . Gets the scroll bar orientation that raised the Scroll event.

Получает тип произошедшего события прокрутки. Gets the type of scroll event that occurred.

Методы

Определяет, равен ли указанный объект текущему объекту. Determines whether the specified object is equal to the current object.

(Унаследовано от Object) GetHashCode()

Служит хэш-функцией по умолчанию. Serves as the default hash function.

(Унаследовано от Object) GetType()

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Унаследовано от Object) MemberwiseClone()

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Унаследовано от Object) ToString()

Возвращает строку, представляющую текущий объект. Returns a string that represents the current object.