ProgressBarControl.Position Property

Gets or sets the progress bar position.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v19.1.dll

Declaration

C#

[DXCategory("Appearance")]
[DefaultValue(0)]
[Bindable(false)]
[SmartTagProperty("Position", "", SmartTagActionType.RefreshBoundsAfterExecute)]
public virtual int Position { get; set; }

VB.NET

<DXCategory("Appearance")>
<DefaultValue(0)>
<Bindable(False)>
<SmartTagProperty("Position", "", SmartTagActionType.RefreshBoundsAfterExecute)>
Public Overridable Property Position As Integer

Property Value

Type	Default	Description
Int32	0	The progress bar’s current position.

Remarks

The Position property specifies the progress that the application has made toward completing a specific operation. The available range of values the Position property can accept is determined by the RepositoryItemProgressBar.Minimum and RepositoryItemProgressBar.Maximum properties.

There are a number of ways to modify the value displayed by the ProgressBarControl other than changing the Position property directly. You can use the RepositoryItemProgressBar.Step property to specify a value to increment the Position property by, and then call the ProgressBarControl.PerformStep method. You can also use the ProgressBarControl.Increment and ProgressBarControl.Decrement methods to correspondingly increase and decrease the progress bar’s position by a specified value.

Changing the Position property value at runtime raises the RepositoryItem.EditValueChanging and RepositoryItem.EditValueChanged events.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Position property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-print-a-custom-usercontrol-that-lays-inside-a-grid-cell-e3992/CS/CustomControlInGrid/ProjectLayoutControl.cs#L42

dateEdit_Now.EditValue = null;
progressBarControl1.Position = 0;
this.Refresh();

how-to-create-trackbarcontrol-with-progressbar-instead-of-a-track-line-e3286/CS/ProgressTrackBar/Form1.cs#L19

    prb = new ProgressBarControl();
    prb.Position = 50;
}

how-to-implement-multi-user-synchronization-with-microsoft-outlook-e39/CS/MainForm.cs#L108

void BeforeSynchronization(int objectCount) {
    progressBarControl1.Position = 0;
    progressBarControl1.Properties.Maximum = objectCount;

custom-form-custom-fields-and-custom-actions-on-reminder-alert-e382/CS/ReminderCustomActions/Form1.cs#L40

this.progressBarControl1.Properties.Maximum = timeBeforeAlert;
this.progressBarControl1.Position = timeBeforeAlert;
this.progressBarControl1.Properties.Step = -1;

how-to-interact-with-a-splash-screen-by-sending-commands-e3576/CS/SplashScreen1.cs#L23

    int pos = (int)arg;
    progressBarControl1.Position = pos;
}

VB.NET

how-to-print-a-custom-usercontrol-that-lays-inside-a-grid-cell-e3992/VB/CustomControlInGrid/ProjectLayoutControl.vb#L40

dateEdit_Now.EditValue = Nothing
progressBarControl1.Position = 0
Me.Refresh()

how-to-create-trackbarcontrol-with-progressbar-instead-of-a-track-line-e3286/VB/ProgressTrackBar/Form1.vb#L18

    InitializeComponent()
    prb.Position = 50
End Sub

how-to-implement-multi-user-synchronization-with-microsoft-outlook-e39/VB/MainForm.vb#L109

Private Sub BeforeSynchronization(ByVal objectCount As Integer)
    progressBarControl1.Position = 0
    progressBarControl1.Properties.Maximum = objectCount

custom-form-custom-fields-and-custom-actions-on-reminder-alert-e382/VB/ReminderCustomActions/Form1.vb#L133

Private Sub Timer1_Tick(ByVal sender As Object, ByVal e As EventArgs)
    If Me.progressBarControl1.Position > Me.progressBarControl1.Properties.Minimum Then
        Me.progressBarControl1.PerformStep()

how-to-interact-with-a-splash-screen-by-sending-commands-e3576/VB/SplashScreen1.vb#L21

    Dim pos As Integer = CInt(arg)
    progressBarControl1.Position = pos
End If