Scroll Bars Перечисление

Определение

Указывает, какие полосы прокрутки будут видны в элементе управления. Specifies which scroll bars will be visible on a control.

Отображаются и горизонтальные, и вертикальные полосы прокрутки. Both horizontal and vertical scroll bars are shown.

Отображаются только горизонтальные полосы прокрутки. Only horizontal scroll bars are shown.

Полосы прокрутки не отображаются. No scroll bars are shown.

Отображаются только вертикальные полосы прокрутки. Only vertical scroll bars are shown.

Примеры

В следующем примере кода показано, как использовать ScrollBars перечисление. Чтобы выполнить пример, вставьте следующий код в форму. The following code example demonstrates how to use the ScrollBars enumeration.To run the example, paste the following code in a form. Вызовите SetFourDifferentScrollBars метод в конструкторе формы или в Load методе обработки событий. Call the SetFourDifferentScrollBars method in the form’s constructor or Load event-handling method.

Комментарии

Это перечисление используется в TextBox.ScrollBars . This enumeration is used by TextBox.ScrollBars.

Не все элементы управления поддерживают полосы прокрутки. Not all controls support scroll bars. Используйте это перечисление, чтобы указать, какие полосы прокрутки будут видны на элементе управления — в некоторых или во всех обстоятельствах. Use this enumeration to specify which scroll bars will be visible on a control, either under some or all circumstances.

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.

Windows forms scrollbar как пользоваться

Полосы прокрутки — важная составляющая любой графической среды. Они улучшают наглядность и облегчают работу пользователя. Полосы прокрутки удобны при отображении любых объектов (текста, графики, таблиц, записей баз данных, картинок, Web-страниц), чьи размеры превышают размеры клиентской области программы.

Полосы прокрутки могут быть ориентированы вертикально (для перемещения вверх–вниз) или горизонтально (вперед–назад). Щелчок по стрелкам на концах полосы прокрутки перемещает документ на небольшое расстояние — обычно на одну строку вверх или вниз (для вертикальной полосы прокрутки). Щелчок по области, расположенной между стрелками, вызывает перемещение на большее расстояние. Ползунок перемещается по длине полосы прокрутки, отображая примерное положение видимой части относительно общей длины документа. Для перехода в определенную область документа можно перетащить ползунок мышью. Относительно недавно размер ползунка на полосе прокрутки стал изменяться, отражая пропорцию видимой части ко всему документу.

Полосы прокрутки можно добавить к форме двумя способами. Первый — создать элементы управления типа VScrollBar и HScrollBar и разместить их в любой части клиентской области программы. Работа полос прокрутки настраивается свойствами этих объектов. При использовании таких полос прокрутки инициируются определенные события. Мы будем работать с такими элементами управления в главе 12.

Второй способ проще. Его часто называют автопрокруткой (auto-scroll), и именно его мы используем в этой главе.

Средство автопрокрутки в первую очередь предназначено для программ, размещающих в своей клиентской части различные элементы управления (например, кнопки и текстовые поля). Включить автопрокрутку для формы можно задав свойству AutoScroll значение true. Тогда, если размера клиентской области не хватит для отображения всех элементов управления, как по волшебству возникнут полосы прокрутки и позволят пользователю добраться до других элементов.

Включить автопрокрутку можно и без каких бы то ни было элементов управления. Я рассмотрю оба способа, а вы уж выбирайте.

Scroll Bar. Value Свойство

Определение

Возвращает или задает численное значение, представляющее текущее положение ползунка на полосе прокрутки. Gets or sets a numeric value that represents the current position of the scroll box on the scroll bar control.

Значение свойства

Числовое значение в интервале от Minimum до Maximum. A numeric value that is within the Minimum and Maximum range. Значение по умолчанию — 0. The default value is 0.

Исключения

Присвоенное значение меньше значения свойства Minimum. The assigned value is less than the Minimum property value.

-или- -or- Присвоенное значение больше значения свойства Maximum. The assigned value is greater than the Maximum property value.

Примеры

В следующем примере изображение прокручивается в рамке изображения. 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.

Scroll Bar. Maximum Свойство

Определение

Возвращает или задает верхнюю границу значений диапазона прокрутки. Gets or sets the upper limit of values of the scrollable range.

Значение свойства

Числовое значение. A numeric value. По умолчанию используется значение 100. The default value is 100.

Примеры

В следующем примере предполагается, что вы создали Form , добавили в объект PictureBox Form и добавили горизонтальную HScrollBar и вертикальную черту VScrollBar PictureBox . The following example assumes that you have created a Form, added a PictureBox to the Form, and added a horizontal HScrollBar and a vertical VScrollBar to the PictureBox. Этот пример кода является частью большого примера, приведенного в разделе ScrollBar Общие сведения о классе. This code example is part of a larger example provided for the ScrollBar class overview.

В этом примере Maximum свойству задается размер и Image Размер полосы прокрутки, если он видим, а также коэффициент размера LargeChange Свойства. In this example, the Maximum property is set to the size of the Image plus the size of the scrollbar if it is visible plus an adjustment factor of the size of the LargeChange property.

System.Drawing System.Windows.Forms Для выполнения этого примера необходимо добавить ссылки на пространства имен и. You must add references to the System.Drawing and System.Windows.Forms namespaces to run this example.

Инструкции по запуску этого примера в 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.

Комментарии

Можно настроить Maximum Динамическое изменение свойства в соответствии с размером родительского элемента полосы прокрутки относительно размера пиксела или от числа отображаемых строк или строк. You might consider adjusting the Maximum property dynamically to match the size of the scroll bar’s parent in proportion to pixel size or to the number of rows or lines displayed.

Максимальное значение может быть достигнуто только программным способом. The maximum value can only be reached programmatically. Значение полосы прокрутки не может достичь максимального значения при взаимодействии с пользователем во время выполнения. The value of a scroll bar cannot reach its maximum value through user interaction at run time. Максимальное значение, которое может быть достигнуто при взаимодействии с пользователем, равно 1 плюс Maximum значение свойства минус LargeChange значение свойства. The maximum value that can be reached through user interaction is equal to 1 plus the Maximum property value minus the LargeChange property value. При необходимости можно присвоить свойству значение, равное Maximum размеру объекта-1, для учета условия 1. If necessary, you can set the Maximum property to the size of the object -1 to account for the term of 1.