> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/korean/development/api-reference/classes/progressbar.md).

# ProgressBar

ProgressBar : `GuiObject`

## Overview

ProgressBar는 현재 진행 상태나 수치를 시각적으로 표시하는 GUI 오브젝트입니다.

수평·수직 게이지뿐만 아니라 원형 및 반원형 게이지를 구성할 수 있으며, `Value` 속성으로 채우기 영역의 비율을 설정할 수 있습니다. `TrackImage`와 `FillImage`를 사용하여 게이지의 바탕 및 채우기 영역에 이미지를 적용할 수 있습니다.

## Properties

### ArcSize

`number`

원형 또는 반원형 ProgressBar에서 표시할 원호의 범위를 지정합니다.

값은 `0`부터 `360` 사이의 각도로 지정합니다.

* `360`: 원형 게이지로 표시합니다.
* `180` 이하: 반원형 게이지로 표시할 수 있습니다.

이 속성은 `FillDirection`이 `Clockwise` 또는 `CounterClockwise`일 때만 사용할 수 있습니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.FillDirection = Enum.ProgressBarFillDirection.Clockwise
ProgressBar.ArcSize = 180
```

### CornerClipEnabled

`boolean`

모서리에 곡률이 적용된 선형 ProgressBar의 채우기 방식을 지정합니다.

* `true`: 채우기 영역을 단순히 잘라냅니다.
* `false`: 채우기 영역의 모서리 곡률을 유지하면서 채웁니다.

이 속성은 `FillDirection`이 선형 채움 방식일 때만 사용할 수 있습니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.CornerClipEnabled = false
```

### FillColor3

`Color3`

채우기 영역에 적용되는 색상을 지정합니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.FillColor3 = Color3.fromRGB(0, 255, 0)
```

### FillCornerRadius

`UDim`

채우기 영역의 모서리 곡률을 지정합니다.

`Scale`은 부모 UI 요소의 크기에 대한 비율을 의미하며, `Offset`은 픽셀 단위의 추가 값을 의미합니다. 값은 `UDim.new(scale, offset)` 형식으로 지정합니다.

이 속성은 `FillDirection`이 선형 채움 방식일 때 사용할 수 있습니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.FillCornerRadius = UDim.new(0.5, 0)
```

### FillDirection

`Enum.ProgressBarFillDirection`

`Value` 속성에 따라 채우기 영역이 확장되는 방향을 지정합니다.

선형 채움 방식과 각도 채움 방식을 설정할 수 있습니다.

* 선형 채움 방식
  * `LeftToRight`
  * `RightToLeft`
  * `TopToBottom`
  * `BottomToTop`
  * `CenterHorizontal`
  * `CenterVertical`
* 각도 채움 방식
  * `Clockwise`
  * `CounterClockwise`

`FillDirection`이 각도 채움 방식인 경우 `StartAngle`과 `ArcSize` 속성을 사용할 수 있습니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.FillDirection = Enum.ProgressBarFillDirection.LeftToRight
```

### FillImage

`string`

ProgressBar의 채우기 영역에 표시할 이미지의 AssetId를 지정합니다.

값은 `ovdrassetid:번호` 형식으로 지정합니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.FillImage = "ovdrassetid:12345"
```

### FillTransparency

`number`

채우기 영역의 투명도를 지정합니다.

`0`은 완전히 불투명한 상태를 의미하고, `1`은 완전히 투명한 상태를 의미합니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.FillTransparency = 0.5
```

### StartAngle

`number`

원형 또는 반원형 ProgressBar에서 채우기 영역이 시작되는 각도를 지정합니다.

값은 `0`부터 `360` 사이의 각도로 지정합니다. 채우기 방향은 `FillDirection` 속성에 따라 결정됩니다.

이 속성은 `FillDirection`이 `Clockwise` 또는 `CounterClockwise`일 때만 사용할 수 있습니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.FillDirection = Enum.ProgressBarFillDirection.Clockwise
ProgressBar.StartAngle = 90
```

### TrackColor3

`Color3`

바탕 영역에 적용되는 색상을 지정합니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.TrackColor3 = Color3.fromRGB(80, 80, 80)
```

### TrackCornerRadius

`UDim`

바탕 영역의 모서리 곡률을 지정합니다.

`Scale`은 부모 UI 요소의 크기에 대한 비율을 의미하며, `Offset`은 픽셀 단위의 추가 값을 의미합니다. 값은 `UDim.new(scale, offset)` 형식으로 지정합니다.

이 속성은 `FillDirection`이 선형 채움 방식일 때 사용할 수 있습니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.TrackCornerRadius = UDim.new(0.5, 0)
```

### TrackImage

`string`

ProgressBar의 바탕 영역에 표시할 이미지의 AssetId를 지정합니다.

값은 `ovdrassetid:번호` 형식으로 지정합니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.TrackImage = "ovdrassetid:12345"
```

### TrackTransparency

`number`

바탕 영역의 투명도를 지정합니다.

`0`은 완전히 불투명한 상태를 의미하고, `1`은 완전히 투명한 상태를 의미합니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.TrackTransparency = 0.5
```

### Value

`number`

채우기 영역의 비율을 지정합니다.

값은 `0`부터 `1` 사이에서 설정합니다.

* `0`: 채우기 영역이 표시되지 않습니다.
* `1`: 채우기 영역이 모두 표시됩니다.

범위를 벗어난 값은 `0` 또는 `1` 사이의 값으로 자동 조정됩니다.

#### Code Samples

```lua
local ProgressBar = script.Parent
ProgressBar.Value = 0.4
```

## Methods

## Events

## See also

{% content-ref url="/pages/K1g0tEWDJhh6a6E4UURk" %}
[GUI](/korean/manual/studio-manual/gui.md)
{% endcontent-ref %}

{% content-ref url="/pages/nF69bAn1NFjm0LxW4GE6" %}
[ProgressBarFillDirection](/korean/development/api-reference/enums/progressbarfilldirection.md)
{% endcontent-ref %}