---
title: "MarqueeProgressBar (Basic)"
canonical: "https://docs.cuesystem.com/space/CVCGC/407404565/MarqueeProgressBar%20(Basic)"
format: markdown
---
# Description

This object is used to indicate that a time-consuming operation is in progress but it is unknown how long it may take. This bar uses the motion of graphic to show that progress is taking place. It is fully resizable

in the horizontal direction and up to three dimensions can be selected in the vertical direction. The object uses standard functions ShowObject for start and HideObject for stop.

![image](media://ef983038-8d9b-49f9-9174-34a2565355f9)

# Properties

|  |  |  |  |  |
| --- | --- | --- | --- | --- |
| Property Name | Data Type | Allowed Values | Default Value | Description |
| Behavior |
| FrameRate | Double | 1 to 25 | 25 | Number of frames that are displayed per second. |
| Appearance |
| ObjectColor | Long | 1 = Blue  
2 = Green  
3 = Yellow  
4 = Orange  
5 = Purple | 1 | Color of object |

# Functions

## SetFrameRate

This function sets FrameRate to newframerate value. It returns True, if newframerate is in range 1 to 25, otherwise it returns False.

#### Syntax

```visualbasic
Function SetFrameRate(newframerate As Double) As Boolean
```

## GetFrameRate

This function returns current FrameRate.

#### Syntax

```visualbasic
Function GetFrameRate() As Double
```

## SetObjectColor

This function sets color of MarqueeProgressBar to newobjectcolor. Possible values are

- 1 = Blue
- 2 = Green
- 3 = Yellow
- 4 = Orange
- 5 = Purple

The function returns True on success or False if an error occurs (parameter is out of limits).

#### Syntax

```visualbasic
Function SetObjectColor(newobjectcolor As Long) As Boolean
```

## GetObjectColor

This function returns current color of MarqueeProgressBar. For possible values see command SetObjectColor.

#### Syntax

```visualbasic
Function GetObjectColor() As Long
```