C#: ProgressBar или волшебная информирующая полоска

Сегодня речь пойдет об использовании в своих программах элемента ProgressBar. Для тех кто в танке — это инфомрер, как правило, отображающий процесс выполнения какого-либо долгого действия. По сути будет рассмотрено два вопроса: «как изменить значение элемента формы из потока» и «как работать с элементом прогресс бар»…
Как всегда начнем с пустого ВинФорм проекта, и добавления на него необходимых элементов: Label, Button, ProgressBar. Не будем заморачиваться по смене стандартных надписей и имен объектов — приступим к решительным действиям.
Данный материал был взят с сайта foolsoft.ru
Так как нам нужно какое-либо трудоемкое действие, то остановимся на умножении большого количества случайных чисел. Нажмем на нашу кнопку два раза и в событии клика по кнопке сгенерируем числа:

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

А далее собственно суть вопроса. Для того что бы приложение продолжало работать без зависания формы в процессе долгой обработки, эту самую обработку стоит выполнять в отдельном потоке. А для того чтобы получить доступ к элементам формы из потока, нужно воспользоваться конструкцией this.Invoke(new ThreadStart(delegate< >));. Имеем:

Данный код создает новый процесс с явным указанием кода, который будет выполняться — пройтись по всем числам, показать в элементе label1 какие два числа мы умножаем и каков результат умножения, увеличивать значение элемента progressBar1 на один каждую итерацию цикла.

Элемент управления ProgressBar (Windows Forms) ProgressBar Control (Windows Forms)

Элемент управления ToolStripProgressBar заменяет элемент управления ProgressBar и расширяет его функциональные возможности; однако при необходимости элемент управления ProgressBar можно сохранить для обратной совместимости и использования в будущем. The ToolStripProgressBar control replaces and adds functionality to the ProgressBar control; however, the ProgressBar control is retained for both backward compatibility and future use, if you choose.

ProgressBarЭлемент управления Windows Forms показывает ход выполнения действия, отображая соответствующее количество прямоугольников, расположенных на горизонтальной полосе. The Windows Forms ProgressBar control indicates the progress of an action by displaying an appropriate number of rectangles arranged in a horizontal bar. После завершения действия Панель заполняется. When the action is complete, the bar is filled. Индикаторы выполнения обычно используются, чтобы дать пользователю указание о том, как долго ожидать завершения завершенного действия — например, при загрузке большого файла. Progress bars are commonly used to give the user an indication of how long to wait for a protracted action to complete—for instance, when a large file is being loaded.

в этом разделе In This Section

Общие сведения об элементе управления ProgressBar ProgressBar Control Overview
Содержит общие понятия ProgressBar элемента управления, позволяющие графически отображать ход выполнения операции. Introduces the general concepts of the ProgressBar control, which enables you to graphically display the progress of an operation.

Справочник Reference

ProgressBar
Справочная информация о классе и его членах. Provides reference information on the class and its members.

Связанные разделы Related Sections

Элементы управления для использования в формах Windows Forms Controls to Use on Windows Forms
Полный список элементов управления Windows Forms со ссылками на информацию об их применении. Provides a complete list of Windows Forms controls, with links to information on their use.

Практическое руководство. Установка значения, отображаемого c помощью элемента управления ProgressBar в Windows Forms How to: Set the Value Displayed by the Windows Forms ProgressBar Control

Элемент управления ToolStripProgressBar заменяет элемент управления ProgressBar и расширяет его функциональные возможности; однако при необходимости элемент управления ProgressBar можно сохранить для обратной совместимости и использования в будущем. The ToolStripProgressBar control replaces and adds functionality to the ProgressBar control; however, the ProgressBar control is retained for both backward compatibility and future use, if you choose.

.NET Framework предоставляет несколько различных способов отобразить заданное значение в ProgressBar элементе управления. The .NET Framework gives you several different ways to display a given value within the ProgressBar control. Выбор способа зависит от поставленной задачи или от решаемой проблемы. Which approach you choose will depend on the task at hand or the problem you are solving. В следующей таблице показаны подходы, которые можно выбрать. The following table shows the approaches you can choose.

Метод Approach	Описание Description
Задайте значение ProgressBar элемента управления напрямую. Set the value of the ProgressBar control directly.	Этот подход удобен для задач, где известно общее количество элементов, которые будут задействованы, например чтение записей из источника данных. This approach is useful for tasks where you know the total of the item measured that will be involved, such as reading records from a data source. Кроме того, если необходимо задать значение только один раз или дважды, это легко сделать. Additionally, if you only need to set the value once or twice, this is an easy way to do it. Наконец, используйте этот процесс, если необходимо уменьшить значение, отображаемое индикатором выполнения. Finally, use this process if you need to decrease the value displayed by the progress bar.
Увеличьте ProgressBar Отображаемое значение на фиксированное. Increase the ProgressBar display by a fixed value.	Этот подход удобен при отображении простого счетчика между минимальным и максимальным значением, например прошедшее время или числом файлов, которые были обработаны из известного итога. This approach is useful when you are displaying a simple count between the minimum and maximum, such as elapsed time or the number of files that have been processed out of a known total.
Увеличьте ProgressBar Отображаемое значение, используя различные значения. Increase the ProgressBar display by a value that varies.	Этот подход удобен, если необходимо изменить отображаемое значение на несколько раз в разных объемах. This approach is useful when you need to change the displayed value a number of times in different amounts. Пример показывает объем занятого места на жестком диске при записи ряда файлов на диск. An example would be showing the amount of hard-disk space being consumed while writing a series of files to the disk.

Самым прямым способом задания значения, отображаемого индикатором выполнения, является установка Value Свойства. The most direct way to set the value displayed by a progress bar is by setting the Value property. Это можно сделать либо во время разработки, либо во время выполнения. This can be done either at design time or at run time.

Установка значения ProgressBar напрямую To set the ProgressBar value directly

Задайте ProgressBar значения элемента управления Minimum и Maximum . Set the ProgressBar control’s Minimum and Maximum values.

В коде задайте для свойства элемента управления Value целочисленное значение между минимальным и максимальным значениями, которые вы установили. In code, set the control’s Value property to an integer value between the minimum and maximum values you have established.

Если задать Value свойство вне границ Minimum , установленных Maximum свойствами и, элемент управления создаст ArgumentException исключение. If you set the Value property outside the boundaries established by the Minimum and Maximum properties, the control throws an ArgumentException exception.

В следующем примере кода показано, как задать ProgressBar значение напрямую. The following code example illustrates how to set the ProgressBar value directly. Код считывает записи из источника данных и обновляет индикатор выполнения и метку при каждом считывании записи данных. The code reads records from a data source and updates the progress bar and label every time a data record is read. Этот пример требует, чтобы форма соработала Label элемент управления, ProgressBar элемент управления и таблицу данных со строкой CustomerRow с именами FirstName и LastName . This example requires that your form has a Label control, a ProgressBar control, and a data table with a row called CustomerRow with FirstName and LastName fields.

При отображении хода выполнения, который выполняется с фиксированным интервалом, можно задать значение и затем вызвать метод, который увеличивает ProgressBar значение элемента управления на этот интервал. Это полезно для таймеров и других сценариев, в которых ход выполнения не измеряется в процентах от целого. This is useful for timers and other scenarios where you are not measuring progress as a percentage of the whole.

Увеличение индикатора выполнения на фиксированное значение To increase the progress bar by a fixed value

Задайте ProgressBar значения элемента управления Minimum и Maximum . Set the ProgressBar control’s Minimum and Maximum values.

Задайте Step для свойства элемента управления целое число, представляющее величину, чтобы увеличить отображаемое значение индикатора выполнения. Set the control’s Step property to an integer representing the amount to increase the progress bar’s displayed value.

Вызовите PerformStep метод, чтобы изменить значение, отображаемое на величину, заданную в Step свойстве. Call the PerformStep method to change the value displayed by the amount set in the Step property.

В следующем примере кода показано, как индикатор выполнения может поддерживать количество файлов в операции копирования. The following code example illustrates how a progress bar can maintain a count of the files in a copy operation.

В следующем примере, когда каждый файл считывается в память, индикатор выполнения и метка обновляются для отражения общего числа считываемых файлов. In the following example, as each file is read into memory, the progress bar and label are updated to reflect the total files read. В этом примере требуется, чтобы форма соработала Label элемент управления и ProgressBar элемент управления. This example requires that your form has a Label control and a ProgressBar control.

Наконец, можно увеличить значение, отображаемое индикатором выполнения, чтобы каждое увеличение было уникальным. Это полезно, если вы отслеживаете ряд уникальных операций, например запись файлов различных размеров на жесткий диск или измерение хода выполнения в процентах от целого. This is useful when you are keeping track of a series of unique operations, such as writing files of different sizes to a hard disk, or measuring progress as a percentage of the whole.

Увеличение индикатора выполнения на динамическое значение To increase the progress bar by a dynamic value

Задайте ProgressBar значения элемента управления Minimum и Maximum . Set the ProgressBar control’s Minimum and Maximum values.

Вызовите Increment метод, чтобы изменить значение, отображаемое указанным целым числом. Call the Increment method to change the value displayed by an integer you specify.

В следующем примере кода показано, как индикатор выполнения может вычислить, сколько места на диске использовалось во время операции копирования. The following code example illustrates how a progress bar can calculate how much disk space has been used during a copy operation.

В следующем примере, когда каждый файл записывается на жесткий диск, индикатор выполнения и метка обновляются с учетом объема доступного места на жестком диске. In the following example, as each file is written to the hard disk, the progress bar and label are updated to reflect the amount of hard-disk space available. В этом примере требуется, чтобы форма соработала Label элемент управления и ProgressBar элемент управления. This example requires that your form has a Label control and a ProgressBar control.

Progress Bar Class

Definition

Represents a Windows progress bar control.

Examples

The following code example uses a ProgressBar control to display the progress of a file copy operation. The example uses the Minimum and Maximum properties to specify a range for the ProgressBar that is equivalent to the number of files to copy. The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. This example requires that you have a ProgressBar control created called pBar1 that is created within a Form and that there is a method created called CopyFile (that returns a Boolean value indicating the file copy operation was completed successfully) that performs the file copy operation. The code also requires that an array of strings containing the files to copy is created and passed to the CopyWithProgress method defined in the example and that the method is called from another method or event in the Form.

Remarks

A ProgressBar control visually indicates the progress of a lengthy operation in one of three styles:

Segmented blocks that increase in steps from left to right.

A continuous bar that fills in from left to right.

A block that scrolls across a ProgressBar in a marquee fashion.

The Style property determines the style of ProgressBar that is displayed. Note that the ProgressBar control can only be oriented horizontally. For an example of how to create a vertically oriented ProgressBar, see the ProgressBarRenderer class. The ProgressBar control is typically used when an application performs tasks such as copying files or printing documents. Users of an application might consider an application unresponsive if there is no visual cue. By using the ProgressBar in your application, you alert the user that the application is performing a lengthy task and that the application is still responding.

The Maximum and Minimum properties define the range of values to represent the progress of a task. The Minimum property is typically set to a value of 0, and the Maximum property is typically set to a value indicating the completion of a task. For example, to properly display the progress when copying a group of files, the Maximum property could be set to the total number of files to be copied.

The Value property represents the progress that the application has made toward completing the operation. The value displayed by the ProgressBar only approximates the current value of the Value property. Based on the size of the ProgressBar, the Value property determines when to display the next block or increase the size of the bar.

There are a number of ways to modify the value displayed by the ProgressBar other than changing the Value property directly. You can use the Step property to specify a specific value to increment the Value property by, and then call the PerformStep method to increment the value. To vary the increment value, you can use the Increment method and specify a value with which to increment the Value property.

ForeColor and BackColor changes for the ProgressBar will not be honored when visual styles are enabled on Windows XP Home Edition, Windows XP Professional, Windows Server 2003 and above.

Constructors

Initializes a new instance of the ProgressBar class.

Properties

Gets the AccessibleObject assigned to the control.

(Inherited from Control) AccessibleDefaultActionDescription

Gets or sets the default action description of the control for use by accessibility client applications.

(Inherited from Control) AccessibleDescription

Gets or sets the description of the control used by accessibility client applications.

(Inherited from Control) AccessibleName

Gets or sets the name of the control used by accessibility client applications.

(Inherited from Control) AccessibleRole

Gets or sets the accessible role of the control.

(Inherited from Control) AllowDrop

Gets or sets a value indicating whether the control can accept data that the user drags onto it.

Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent.

(Inherited from Control) AutoScrollOffset

Gets or sets where this control is scrolled to in ScrollControlIntoView(Control).

(Inherited from Control) AutoSize

This property is not relevant for this class.

(Inherited from Control) BackColor

Gets or sets the background color for this ProgressBar control.

Gets or sets the background color for the control.

(Inherited from Control) BackgroundImage

Gets or sets the background image for the ProgressBar control.

Gets or sets the layout of the background image of the progress bar.

Gets or sets the background image layout as defined in the ImageLayout enumeration.

(Inherited from Control) BindingContext

Gets or sets the BindingContext for the control.

(Inherited from Control) Bottom

Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container’s client area.

(Inherited from Control) Bounds

Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.

(Inherited from Control) CanEnableIme

Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support.

(Inherited from Control) CanFocus

Gets a value indicating whether the control can receive focus.

(Inherited from Control) CanRaiseEvents

Determines if events can be raised on the control.

(Inherited from Control) CanSelect

Gets a value indicating whether the control can be selected.

(Inherited from Control) Capture

Gets or sets a value indicating whether the control has captured the mouse.

(Inherited from Control) CausesValidation

Gets or sets a value indicating whether the control, when it receives focus, causes validation to be performed on any controls that require validation.

Gets the rectangle that represents the client area of the control.

(Inherited from Control) ClientSize

Gets or sets the height and width of the client area of the control.

(Inherited from Control) CompanyName

Gets the name of the company or creator of the application containing the control.

(Inherited from Control) Container

Gets the IContainer that contains the Component.

(Inherited from Component) ContainsFocus

Gets a value indicating whether the control, or one of its child controls, currently has the input focus.

(Inherited from Control) ContextMenu

Gets or sets the shortcut menu associated with the control.

(Inherited from Control) ContextMenuStrip

Gets or sets the ContextMenuStrip associated with this control.

(Inherited from Control) Controls

Gets the collection of controls contained within the control.

(Inherited from Control) Created

Gets a value indicating whether the control has been created.

(Inherited from Control) CreateParams

Gets the required creation parameters when the control handle is created.

(Inherited from Control) Cursor

Gets or sets the cursor that is displayed when the mouse pointer is over the control.

(Inherited from Control) DataBindings

Gets the data bindings for the control.

(Inherited from Control) DefaultCursor

Gets or sets the default cursor for the control.

(Inherited from Control) DefaultImeMode

Gets the default Input Method Editor (IME) mode supported by the control.

Gets the default Input Method Editor (IME) mode supported by the control.

(Inherited from Control) DefaultMargin

Gets the space, in pixels, that is specified by default between controls.

(Inherited from Control) DefaultMaximumSize

Gets the length and height, in pixels, that is specified as the default maximum size of a control.

(Inherited from Control) DefaultMinimumSize

Gets the length and height, in pixels, that is specified as the default minimum size of a control.

(Inherited from Control) DefaultPadding

Gets the internal spacing, in pixels, of the contents of a control.

(Inherited from Control) DefaultSize

Gets the default size of the control.

Gets the default size of the control.

(Inherited from Control) DesignMode

Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component) DeviceDpi

Gets the DPI value for the display device where the control is currently being displayed.

(Inherited from Control) DisplayRectangle

Gets the rectangle that represents the display area of the control.

(Inherited from Control) Disposing

Gets a value indicating whether the base Control class is in the process of disposing.

(Inherited from Control) Dock

Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

(Inherited from Control) DoubleBuffered

Gets or sets a value indicating whether the control should redraw its surface using a secondary buffer.

Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.

(Inherited from Control) Enabled

Gets or sets a value indicating whether the control can respond to user interaction.

(Inherited from Control) Events

Gets the list of event handlers that are attached to this Component.

(Inherited from Component) Focused

Gets a value indicating whether the control has input focus.

(Inherited from Control) Font

Gets or sets the font of text in the ProgressBar.

Gets or sets the height of the font of the control.

(Inherited from Control) ForeColor

Gets or sets the foreground color of the control.

Gets or sets the foreground color of the control.

(Inherited from Control) Handle

Gets the window handle that the control is bound to.

(Inherited from Control) HasChildren

Gets a value indicating whether the control contains one or more child controls.

(Inherited from Control) Height

Gets or sets the height of the control.

(Inherited from Control) ImeMode

Gets or sets the input method editor (IME) for the ProgressBar

Gets or sets the IME mode of a control.

(Inherited from Control) InvokeRequired

Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on.

(Inherited from Control) IsAccessible

Gets or sets a value indicating whether the control is visible to accessibility applications.

(Inherited from Control) IsDisposed

Gets a value indicating whether the control has been disposed of.

(Inherited from Control) IsHandleCreated

Gets a value indicating whether the control has a handle associated with it.

(Inherited from Control) IsMirrored

Gets a value indicating whether the control is mirrored.

(Inherited from Control) LayoutEngine

Gets a cached instance of the control’s layout engine.

(Inherited from Control) Left

Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container’s client area.

(Inherited from Control) Location

Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.

(Inherited from Control) Margin

Gets or sets the space between controls.

(Inherited from Control) MarqueeAnimationSpeed

Gets or sets the time period, in milliseconds, that it takes the progress block to scroll across the progress bar.

Gets or sets the maximum value of the range of the control.

Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify.

(Inherited from Control) Minimum

Gets or sets the minimum value of the range of the control.

Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify.

(Inherited from Control) Name

Gets or sets the name of the control.

(Inherited from Control) Padding

Gets or sets the space between the edges of a ProgressBar control and its contents.

Gets or sets padding within the control.

(Inherited from Control) Parent

Gets or sets the parent container of the control.

(Inherited from Control) PreferredSize

Gets the size of a rectangular area into which the control can fit.

(Inherited from Control) ProductName

Gets the product name of the assembly containing the control.

(Inherited from Control) ProductVersion

Gets the version of the assembly containing the control.

(Inherited from Control) RecreatingHandle

Gets a value indicating whether the control is currently re-creating its handle.

(Inherited from Control) Region

Gets or sets the window region associated with the control.

(Inherited from Control) RenderRightToLeft

This property is now obsolete.

(Inherited from Control) ResizeRedraw

Gets or sets a value indicating whether the control redraws itself when resized.

(Inherited from Control) Right

Gets the distance, in pixels, between the right edge of the control and the left edge of its container’s client area.

(Inherited from Control) RightToLeft

Gets or sets a value that indicates whether the control’s elements are aligned to support locales using right-to-left fonts.

Gets or sets a value indicating whether control’s elements are aligned to support locales using right-to-left fonts.

(Inherited from Control) RightToLeftLayout

Gets or sets a value indicating whether the ProgressBar and any text it contains is displayed from right to left.

Gets a value that determines the scaling of child controls.

(Inherited from Control) ShowFocusCues

Gets a value indicating whether the control should display focus rectangles.

(Inherited from Control) ShowKeyboardCues

Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators.

(Inherited from Control) Site

Gets or sets the site of the control.

(Inherited from Control) Size

Gets or sets the height and width of the control.

(Inherited from Control) Step

Gets or sets the amount by which a call to the PerformStep() method increases the current position of the progress bar.

Gets or sets the manner in which progress should be indicated on the progress bar.

Gets or sets the tab order of the control within its container.

(Inherited from Control) TabStop

Gets or sets the object that contains data about the control.

(Inherited from Control) Text

Gets or sets the text associated with this control.

Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container’s client area.

(Inherited from Control) TopLevelControl

Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in.

(Inherited from Control) UseWaitCursor

Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls.

(Inherited from Control) Value

Gets or sets the current position of the progress bar.

Gets or sets a value indicating whether the control and all its child controls are displayed.

(Inherited from Control) Width

Gets or sets the width of the control.

(Inherited from Control) WindowTarget

This property is not relevant for this class.

(Inherited from Control)

Methods

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.

(Inherited from Control) AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .

(Inherited from Control) BeginInvoke(Delegate)

Executes the specified delegate asynchronously on the thread that the control’s underlying handle was created on.

(Inherited from Control) BeginInvoke(Delegate, Object[])

Executes the specified delegate asynchronously with the specified arguments, on the thread that the control’s underlying handle was created on.

(Inherited from Control) BringToFront()

Brings the control to the front of the z-order.

(Inherited from Control) Contains(Control)

Retrieves a value indicating whether the specified control is a child of the control.

(Inherited from Control) CreateAccessibilityInstance()

Creates a new instance of the accessibility object for the ProgressBar control.

Creates a new accessibility object for the control.

(Inherited from Control) CreateControl()

Forces the creation of the visible control, including the creation of the handle and any visible child controls.

(Inherited from Control) CreateControlsInstance()

Creates a new instance of the control collection for the control.

(Inherited from Control) CreateGraphics()

Creates the Graphics for the control.

(Inherited from Control) CreateHandle()

Creates a handle for the control.

Creates a handle for the control.

(Inherited from Control) CreateObjRef(Type)

Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject) DefWndProc(Message)

Sends the specified message to the default window procedure.

(Inherited from Control) DestroyHandle()

Destroys the handle associated with the control.

(Inherited from Control) Dispose()

Releases all resources used by the Component.

(Inherited from Component) Dispose(Boolean)

Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources.

(Inherited from Control) DoDragDrop(Object, DragDropEffects)

Begins a drag-and-drop operation.

(Inherited from Control) DrawToBitmap(Bitmap, Rectangle)

Supports rendering to the specified bitmap.

(Inherited from Control) EndInvoke(IAsyncResult)

Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed.

(Inherited from Control) Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object) FindForm()

Retrieves the form that the control is on.

(Inherited from Control) Focus()

Sets input focus to the control.

(Inherited from Control) GetAccessibilityObjectById(Int32)

Retrieves the specified AccessibleObject.

(Inherited from Control) GetAutoSizeMode()

Retrieves a value indicating how a control will behave when its AutoSize property is enabled.

(Inherited from Control) GetChildAtPoint(Point)

Retrieves the child control that is located at the specified coordinates.

(Inherited from Control) GetChildAtPoint(Point, GetChildAtPointSkip)

Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.

(Inherited from Control) GetContainerControl()

Returns the next ContainerControl up the control’s chain of parent controls.

(Inherited from Control) GetHashCode()

Serves as the default hash function.

(Inherited from Object) GetLifetimeService()

Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject) GetNextControl(Control, Boolean)

Retrieves the next control forward or back in the tab order of child controls.

(Inherited from Control) GetPreferredSize(Size)

Retrieves the size of a rectangular area into which a control can be fitted.

(Inherited from Control) GetScaledBounds(Rectangle, SizeF, BoundsSpecified)

Retrieves the bounds within which the control is scaled.

(Inherited from Control) GetService(Type)

Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component) GetStyle(ControlStyles)

Retrieves the value of the specified control style bit for the control.

(Inherited from Control) GetTopLevel()

Determines if the control is a top-level control.

(Inherited from Control) GetType()

Gets the Type of the current instance.

(Inherited from Object) Hide()

Conceals the control from the user.

(Inherited from Control) Increment(Int32)

Advances the current position of the progress bar by the specified amount.

Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject) InitLayout()

Called after the control has been added to another container.

(Inherited from Control) Invalidate()

Invalidates the entire surface of the control and causes the control to be redrawn.

(Inherited from Control) Invalidate(Boolean)

Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control) Invalidate(Rectangle)

Invalidates the specified region of the control (adds it to the control’s update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.

(Inherited from Control) Invalidate(Rectangle, Boolean)

Invalidates the specified region of the control (adds it to the control’s update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control) Invalidate(Region)

Invalidates the specified region of the control (adds it to the control’s update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.

(Inherited from Control) Invalidate(Region, Boolean)

Invalidates the specified region of the control (adds it to the control’s update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

(Inherited from Control) Invoke(Delegate)

Executes the specified delegate on the thread that owns the control’s underlying window handle.

(Inherited from Control) Invoke(Delegate, Object[])

Executes the specified delegate, on the thread that owns the control’s underlying window handle, with the specified list of arguments.

(Inherited from Control) InvokeGotFocus(Control, EventArgs)

Raises the GotFocus event for the specified control.

(Inherited from Control) InvokeLostFocus(Control, EventArgs)

Raises the LostFocus event for the specified control.

(Inherited from Control) InvokeOnClick(Control, EventArgs)

Raises the Click event for the specified control.

(Inherited from Control) InvokePaint(Control, PaintEventArgs)

Raises the Paint event for the specified control.

(Inherited from Control) InvokePaintBackground(Control, PaintEventArgs)

Raises the PaintBackground event for the specified control.

(Inherited from Control) IsInputChar(Char)

Determines if a character is an input character that the control recognizes.

(Inherited from Control) IsInputKey(Keys)

Determines whether the specified key is a regular input key or a special key that requires preprocessing.

(Inherited from Control) LogicalToDeviceUnits(Int32)

Converts a Logical DPI value to its equivalent DeviceUnit DPI value.

(Inherited from Control) LogicalToDeviceUnits(Size)

Transforms a size from logical to device units by scaling it for the current DPI and rounding down to the nearest integer value for width and height.

(Inherited from Control) MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object) MemberwiseClone(Boolean)

Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject) NotifyInvalidate(Rectangle)

Raises the Invalidated event with a specified region of the control to invalidate.

(Inherited from Control) OnAutoSizeChanged(EventArgs)

(Inherited from Control) OnBackColorChanged(EventArgs)

(Inherited from Control) OnBackgroundImageChanged(EventArgs)

(Inherited from Control) OnBackgroundImageLayoutChanged(EventArgs)

(Inherited from Control) OnBindingContextChanged(EventArgs)

(Inherited from Control) OnCausesValidationChanged(EventArgs)

(Inherited from Control) OnChangeUICues(UICuesEventArgs)

Raises the ChangeUICues event.

(Inherited from Control) OnClick(EventArgs)

Raises the Click event.

(Inherited from Control) OnClientSizeChanged(EventArgs)

(Inherited from Control) OnContextMenuChanged(EventArgs)

(Inherited from Control) OnContextMenuStripChanged(EventArgs)

(Inherited from Control) OnControlAdded(ControlEventArgs)

Raises the ControlAdded event.

(Inherited from Control) OnControlRemoved(ControlEventArgs)

(Inherited from Control) OnCreateControl()

(Inherited from Control) OnCursorChanged(EventArgs)

(Inherited from Control) OnDockChanged(EventArgs)

Raises the DockChanged event.

(Inherited from Control) OnDoubleClick(EventArgs)

Raises the DoubleClick event.

(Inherited from Control) OnDpiChangedAfterParent(EventArgs)

(Inherited from Control) OnDpiChangedBeforeParent(EventArgs)

(Inherited from Control) OnDragDrop(DragEventArgs)

Raises the DragDrop event.

(Inherited from Control) OnDragEnter(DragEventArgs)

Raises the DragEnter event.

(Inherited from Control) OnDragLeave(EventArgs)

Raises the DragLeave event.

(Inherited from Control) OnDragOver(DragEventArgs)

Raises the DragOver event.

(Inherited from Control) OnEnabledChanged(EventArgs)

(Inherited from Control) OnEnter(EventArgs)

Raises the Enter event.

(Inherited from Control) OnFontChanged(EventArgs)

Raises the FontChanged event.

(Inherited from Control) OnForeColorChanged(EventArgs)

(Inherited from Control) OnGiveFeedback(GiveFeedbackEventArgs)

Raises the GiveFeedback event.

(Inherited from Control) OnGotFocus(EventArgs)

Raises the GotFocus event.

(Inherited from Control) OnHandleCreated(EventArgs)

(Inherited from Control) OnHandleDestroyed(EventArgs)

(Inherited from Control) OnHelpRequested(HelpEventArgs)

(Inherited from Control) OnImeModeChanged(EventArgs)

(Inherited from Control) OnInvalidated(InvalidateEventArgs)

Raises the Invalidated event.

(Inherited from Control) OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

(Inherited from Control) OnKeyPress(KeyPressEventArgs)

Raises the KeyPress event.

(Inherited from Control) OnKeyUp(KeyEventArgs)

Raises the KeyUp event.

(Inherited from Control) OnLayout(LayoutEventArgs)

Raises the Layout event.

(Inherited from Control) OnLeave(EventArgs)

Raises the Leave event.

(Inherited from Control) OnLocationChanged(EventArgs)

(Inherited from Control) OnLostFocus(EventArgs)

Raises the LostFocus event.

(Inherited from Control) OnMarginChanged(EventArgs)

(Inherited from Control) OnMouseCaptureChanged(EventArgs)

(Inherited from Control) OnMouseClick(MouseEventArgs)

Raises the MouseClick event.

(Inherited from Control) OnMouseDoubleClick(MouseEventArgs)

(Inherited from Control) OnMouseDown(MouseEventArgs)

Raises the MouseDown event.

(Inherited from Control) OnMouseEnter(EventArgs)

Raises the MouseEnter event.

(Inherited from Control) OnMouseHover(EventArgs)

Raises the MouseHover event.

(Inherited from Control) OnMouseLeave(EventArgs)

Raises the MouseLeave event.

(Inherited from Control) OnMouseMove(MouseEventArgs)

Raises the MouseMove event.

(Inherited from Control) OnMouseUp(MouseEventArgs)

Raises the MouseUp event.

(Inherited from Control) OnMouseWheel(MouseEventArgs)

Raises the MouseWheel event.

(Inherited from Control) OnMove(EventArgs)

Raises the Move event.

(Inherited from Control) OnNotifyMessage(Message)

Notifies the control of Windows messages.

(Inherited from Control) OnPaddingChanged(EventArgs)

(Inherited from Control) OnPaint(PaintEventArgs)

Raises the Paint event.

(Inherited from Control) OnPaintBackground(PaintEventArgs)

Paints the background of the control.

(Inherited from Control) OnParentBackColorChanged(EventArgs)

Raises the BackColorChanged event when the BackColor property value of the control’s container changes.

(Inherited from Control) OnParentBackgroundImageChanged(EventArgs)

Raises the BackgroundImageChanged event when the BackgroundImage property value of the control’s container changes.

(Inherited from Control) OnParentBindingContextChanged(EventArgs)

Raises the BindingContextChanged event when the BindingContext property value of the control’s container changes.

(Inherited from Control) OnParentChanged(EventArgs)

(Inherited from Control) OnParentCursorChanged(EventArgs)

(Inherited from Control) OnParentEnabledChanged(EventArgs)

Raises the EnabledChanged event when the Enabled property value of the control’s container changes.

(Inherited from Control) OnParentFontChanged(EventArgs)

Raises the FontChanged event when the Font property value of the control’s container changes.

(Inherited from Control) OnParentForeColorChanged(EventArgs)

Raises the ForeColorChanged event when the ForeColor property value of the control’s container changes.

(Inherited from Control) OnParentRightToLeftChanged(EventArgs)

Raises the RightToLeftChanged event when the RightToLeft property value of the control’s container changes.

(Inherited from Control) OnParentVisibleChanged(EventArgs)

Raises the VisibleChanged event when the Visible property value of the control’s container changes.

(Inherited from Control) OnPreviewKeyDown(PreviewKeyDownEventArgs)

(Inherited from Control) OnPrint(PaintEventArgs)

Raises the Paint event.

(Inherited from Control) OnQueryContinueDrag(QueryContinueDragEventArgs)

(Inherited from Control) OnRegionChanged(EventArgs)

(Inherited from Control) OnResize(EventArgs)

Raises the Resize event.

(Inherited from Control) OnRightToLeftChanged(EventArgs)

(Inherited from Control) OnRightToLeftLayoutChanged(EventArgs)

Raises the SizeChanged event.

(Inherited from Control) OnStyleChanged(EventArgs)

Raises the StyleChanged event.

(Inherited from Control) OnSystemColorsChanged(EventArgs)

(Inherited from Control) OnTabIndexChanged(EventArgs)

(Inherited from Control) OnTabStopChanged(EventArgs)

(Inherited from Control) OnTextChanged(EventArgs)

Raises the TextChanged event.

(Inherited from Control) OnValidated(EventArgs)

Raises the Validated event.

(Inherited from Control) OnValidating(CancelEventArgs)

Raises the Validating event.

(Inherited from Control) OnVisibleChanged(EventArgs)

(Inherited from Control) PerformLayout()

Forces the control to apply layout logic to all its child controls.

(Inherited from Control) PerformLayout(Control, String)

Forces the control to apply layout logic to all its child controls.

(Inherited from Control) PerformStep()

Advances the current position of the progress bar by the amount of the Step property.

Computes the location of the specified screen point into client coordinates.

(Inherited from Control) PointToScreen(Point)

Computes the location of the specified client point into screen coordinates.

(Inherited from Control) PreProcessControlMessage(Message)

Preprocesses keyboard or input messages within the message loop before they are dispatched.

(Inherited from Control) PreProcessMessage(Message)

Preprocesses keyboard or input messages within the message loop before they are dispatched.

(Inherited from Control) ProcessCmdKey(Message, Keys)

Processes a command key.

(Inherited from Control) ProcessDialogChar(Char)

Processes a dialog character.

(Inherited from Control) ProcessDialogKey(Keys)

Processes a dialog key.

(Inherited from Control) ProcessKeyEventArgs(Message)

Processes a key message and generates the appropriate control events.

(Inherited from Control) ProcessKeyMessage(Message)

Processes a keyboard message.

(Inherited from Control) ProcessKeyPreview(Message)

Previews a keyboard message.

(Inherited from Control) ProcessMnemonic(Char)

Processes a mnemonic character.

(Inherited from Control) RaiseDragEvent(Object, DragEventArgs)

Raises the appropriate drag event.

(Inherited from Control) RaiseKeyEvent(Object, KeyEventArgs)

Raises the appropriate key event.

(Inherited from Control) RaiseMouseEvent(Object, MouseEventArgs)

Raises the appropriate mouse event.

(Inherited from Control) RaisePaintEvent(Object, PaintEventArgs)

Raises the appropriate paint event.

(Inherited from Control) RecreateHandle()

Forces the re-creation of the handle for the control.

(Inherited from Control) RectangleToClient(Rectangle)

Computes the size and location of the specified screen rectangle in client coordinates.

(Inherited from Control) RectangleToScreen(Rectangle)

Computes the size and location of the specified client rectangle in screen coordinates.

(Inherited from Control) Refresh()

Forces the control to invalidate its client area and immediately redraw itself and any child controls.

(Inherited from Control) RescaleConstantsForDpi(Int32, Int32)

Provides constants for rescaling the control when a DPI change occurs.

(Inherited from Control) ResetBackColor()

Resets the BackColor property to its default value.

(Inherited from Control) ResetBindings()

Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

(Inherited from Control) ResetCursor()

Resets the Cursor property to its default value.

(Inherited from Control) ResetFont()

Resets the Font property to its default value.

(Inherited from Control) ResetForeColor()

Resets the ForeColor to its default value.

Resets the ForeColor property to its default value.

(Inherited from Control) ResetImeMode()

Resets the ImeMode property to its default value.

(Inherited from Control) ResetMouseEventArgs()

Resets the control to handle the MouseLeave event.

(Inherited from Control) ResetRightToLeft()

Resets the RightToLeft property to its default value.

(Inherited from Control) ResetText()

Resets the Text property to its default value (Empty).

(Inherited from Control) ResumeLayout()

Resumes usual layout logic.

(Inherited from Control) ResumeLayout(Boolean)

Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests.

(Inherited from Control) RtlTranslateAlignment(ContentAlignment)

Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.

(Inherited from Control) RtlTranslateAlignment(HorizontalAlignment)

Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.

(Inherited from Control) RtlTranslateAlignment(LeftRightAlignment)

Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.

(Inherited from Control) RtlTranslateContent(ContentAlignment)

Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.

(Inherited from Control) RtlTranslateHorizontal(HorizontalAlignment)

Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.

(Inherited from Control) RtlTranslateLeftRight(LeftRightAlignment)

Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.

(Inherited from Control) Scale(Single)

Scales the control and any child controls.

(Inherited from Control) Scale(Single, Single)

Scales the entire control and any child controls.

(Inherited from Control) Scale(SizeF)

Scales the control and all child controls by the specified scaling factor.

(Inherited from Control) ScaleBitmapLogicalToDevice(Bitmap)

Scales a logical bitmap value to it’s equivalent device unit value when a DPI change occurs.

(Inherited from Control) ScaleControl(SizeF, BoundsSpecified)

Scales a control’s location, size, padding and margin.

(Inherited from Control) ScaleCore(Single, Single)

This method is not relevant for this class.

(Inherited from Control) Select()

Activates the control.

(Inherited from Control) Select(Boolean, Boolean)

Activates a child control. Optionally specifies the direction in the tab order to select the control from.

(Inherited from Control) SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean)

Activates the next control.

(Inherited from Control) SendToBack()

Sends the control to the back of the z-order.

(Inherited from Control) SetAutoSizeMode(AutoSizeMode)

Sets a value indicating how a control will behave when its AutoSize property is enabled.

(Inherited from Control) SetBounds(Int32, Int32, Int32, Int32)

Sets the bounds of the control to the specified location and size.

(Inherited from Control) SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)

Sets the specified bounds of the control to the specified location and size.

(Inherited from Control) SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)

Performs the work of setting the specified bounds of this control.

(Inherited from Control) SetClientSizeCore(Int32, Int32)

Sets the size of the client area of the control.

(Inherited from Control) SetStyle(ControlStyles, Boolean)

Sets a specified ControlStyles flag to either true or false .

(Inherited from Control) SetTopLevel(Boolean)

Sets the control as the top-level control.

(Inherited from Control) SetVisibleCore(Boolean)

Sets the control to the specified visible state.

(Inherited from Control) Show()

Displays the control to the user.

(Inherited from Control) SizeFromClientSize(Size)

Determines the size of the entire control from the height and width of its client area.

(Inherited from Control) SuspendLayout()

Temporarily suspends the layout logic for the control.

(Inherited from Control) ToString()

Returns a string that represents the ProgressBar control.

Causes the control to redraw the invalidated regions within its client area.

(Inherited from Control) UpdateBounds()

Updates the bounds of the control with the current size and location.

(Inherited from Control) UpdateBounds(Int32, Int32, Int32, Int32)

Updates the bounds of the control with the specified size and location.

(Inherited from Control) UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)

Updates the bounds of the control with the specified size, location, and client size.

(Inherited from Control) UpdateStyles()

Forces the assigned styles to be reapplied to the control.

(Inherited from Control) UpdateZOrder()

Updates the control in its parent’s z-order.

(Inherited from Control) WndProc(Message)

Processes Windows messages.

(Inherited from Control)

Events

This event is not relevant for this class.

(Inherited from Control) BackColorChanged

Occurs when the BackColor property changes.

Occurs when the value of the BackColor property changes.

(Inherited from Control) BackgroundImageChanged

Occurs when the value of the BackgroundImage property changes.

Occurs when the value of the BackgroundImageLayout property changes.

Occurs when the BackgroundImageLayout property changes.

(Inherited from Control) BindingContextChanged

Occurs when the value of the BindingContext property changes.

(Inherited from Control) CausesValidationChanged

Occurs when the value of the CausesValidation property changes.

Occurs when the focus or keyboard user interface (UI) cues change.

(Inherited from Control) Click

Occurs when the control is clicked.

(Inherited from Control) ClientSizeChanged

Occurs when the value of the ClientSize property changes.

(Inherited from Control) ContextMenuChanged

Occurs when the value of the ContextMenu property changes.

(Inherited from Control) ContextMenuStripChanged

Occurs when the value of the ContextMenuStrip property changes.

(Inherited from Control) ControlAdded

Occurs when a new control is added to the Control.ControlCollection.

(Inherited from Control) ControlRemoved

Occurs when a control is removed from the Control.ControlCollection.

(Inherited from Control) CursorChanged

Occurs when the value of the Cursor property changes.

(Inherited from Control) Disposed

Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component) DockChanged

Occurs when the value of the Dock property changes.

(Inherited from Control) DoubleClick

Occurs when the user double-clicks the control.

Occurs when the DPI setting for a control is changed programmatically after the DPI of its parent control or form has changed.

(Inherited from Control) DpiChangedBeforeParent

Occurs when the DPI setting for a control is changed programmatically before a DPI change event for its parent control or form has occurred.

(Inherited from Control) DragDrop

Occurs when a drag-and-drop operation is completed.

(Inherited from Control) DragEnter

Occurs when an object is dragged into the control’s bounds.

(Inherited from Control) DragLeave

Occurs when an object is dragged out of the control’s bounds.

(Inherited from Control) DragOver

Occurs when an object is dragged over the control’s bounds.

(Inherited from Control) EnabledChanged

Occurs when the Enabled property value has changed.

(Inherited from Control) Enter

Occurs when focus enters the ProgressBar control.

Occurs when the value of the Font property changes.

Occurs when the ForeColor property value changes.

Occurs when the ForeColor property value changes.

(Inherited from Control) GiveFeedback

Occurs during a drag operation.

(Inherited from Control) GotFocus

Occurs when the control receives focus.

(Inherited from Control) HandleCreated

Occurs when a handle is created for the control.

(Inherited from Control) HandleDestroyed

Occurs when the control’s handle is in the process of being destroyed.

(Inherited from Control) HelpRequested

Occurs when the user requests help for a control.

(Inherited from Control) ImeModeChanged

Occurs when the value of the ImeMode property changes.

Occurs when a control’s display requires redrawing.

(Inherited from Control) KeyDown

Occurs when the user presses a key while the control has focus.

Occurs when the user presses a key while the control has focus.

Occurs when the user releases a key while the control has focus.

Occurs when a control should reposition its child controls.

(Inherited from Control) Leave

Occurs when focus leaves the ProgressBar control.

Occurs when the Location property value has changed.

(Inherited from Control) LostFocus

Occurs when the control loses focus.

(Inherited from Control) MarginChanged

Occurs when the control’s margin changes.

(Inherited from Control) MouseCaptureChanged

Occurs when the control loses mouse capture.

(Inherited from Control) MouseClick

Occurs when the control is clicked by the mouse.

(Inherited from Control) MouseDoubleClick

Occurs when the user double-clicks the control.

Occurs when the control is double clicked by the mouse.

(Inherited from Control) MouseDown

Occurs when the mouse pointer is over the control and a mouse button is pressed.

(Inherited from Control) MouseEnter

Occurs when the mouse pointer enters the control.

(Inherited from Control) MouseHover

Occurs when the mouse pointer rests on the control.

(Inherited from Control) MouseLeave

Occurs when the mouse pointer leaves the control.

(Inherited from Control) MouseMove

Occurs when the mouse pointer is moved over the control.

(Inherited from Control) MouseUp

Occurs when the mouse pointer is over the control and a mouse button is released.

(Inherited from Control) MouseWheel

Occurs when the mouse wheel moves while the control has focus.

(Inherited from Control) Move

Occurs when the control is moved.

(Inherited from Control) PaddingChanged

Occurs when the value of the Padding property changes.

Occurs when the control’s padding changes.

(Inherited from Control) Paint

Occurs when the ProgressBar is drawn.

Occurs when the Parent property value changes.

(Inherited from Control) PreviewKeyDown

Occurs before the KeyDown event when a key is pressed while focus is on this control.

(Inherited from Control) QueryAccessibilityHelp

Occurs when AccessibleObject is providing help to accessibility applications.

(Inherited from Control) QueryContinueDrag

Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.

(Inherited from Control) RegionChanged

Occurs when the value of the Region property changes.

(Inherited from Control) Resize

Occurs when the control is resized.

(Inherited from Control) RightToLeftChanged

Occurs when the RightToLeft property value changes.

Occurs when the RightToLeft property value changes.

(Inherited from Control) RightToLeftLayoutChanged

Occurs when the RightToLeftLayout property changes.

Occurs when the Size property value changes.

(Inherited from Control) StyleChanged

Occurs when the control style changes.

(Inherited from Control) SystemColorsChanged

Occurs when the system colors change.

(Inherited from Control) TabIndexChanged

Occurs when the TabIndex property value changes.

(Inherited from Control) TabStopChanged

Occurs when the TabStop property changes.

Occurs when the Text property changes.

Occurs when the control is finished validating.

(Inherited from Control) Validating

Occurs when the control is validating.

(Inherited from Control) VisibleChanged

Occurs when the Visible property value changes.