# ProgressBar

A `ProgressBar` control visually indicates operation progress.

The `Style` property determines the display style. The `ProgressBar` can only be oriented horizontally and is typically used when performing tasks such as copying files or printing documents. Using a `ProgressBar` alerts users that the application is performing a task and remains responsive.

{% hint style="info" %}
For a full list of properties, methods and events see the [API documentation.](http://docs.wisej.com/api)
{% endhint %}

## Features

### Maximum and Minimum

The `ProgressBar` can specify custom integer values for the `Maximum` and `Minimum` properties.

![ProgressBar control showing maximum and minimum value configuration](/files/-Mf-Aved_IHgVCwEoP4T)

## How To

### Customize the Appearance

The `ProgressBar` control can be customized through the `Font`, `Color`, and `AppearanceKey` properties.

#### Appearance Key

The `ProgressBar` control can be customized to show any predefined theme appearance by setting the `AppearanceKey` property.

![ProgressBar demonstrating custom theme appearance changes](/files/-Mh-URHLLziJLtMVFSpe)

#### Font

Like most other controls, the `ProgressBar` control has a `Font` property that allows for customization of the size, features, and style of font.

![ProgressBar showing custom font settings](/files/-Mh-956AU1DMxzt0Esey)

#### Color

The `ProgressBar` has three color properties:

* `ForeColor`: Changes the text color
* `BackColor`: Controls the container color
* `BarColor`: Controls the color of the progress bar

![ProgressBar displaying custom color configurations](/files/-Mh-AY-2WYwHocChCQzR)

## Advanced

### JavaScript Widget

| Item             | Description                                                                                                                                           |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Class name       | "wisej.web.ProgressBar"                                                                                                                               |
| Theme appearance | "progressbar", see [Themes](https://docs.wisej.com/theme-builder/theme-elements/elements).                                                            |
| Child components | "progress" is the container that displays the value. "label" is the progress bar's text. See [JavaScript](/docs/concepts/javascript-object-model.md). |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)                                   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wisej.com/docs/controls/content/progressbar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.