ProgressBar

ProgressBar : GuiObject

Overview

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

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

Properties

ArcSize

number

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

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

• 360: 원형 게이지로 표시합니다.

• 180 이하: 반원형 게이지로 표시할 수 있습니다.

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

Code Samples

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

CornerClipEnabled

boolean

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

• true: 채우기 영역을 단순히 잘라냅니다.

• false: 채우기 영역의 모서리 곡률을 유지하면서 채웁니다.

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

Code Samples

local ProgressBar = script.Parent
ProgressBar.CornerClipEnabled = false

FillColor3

Color3

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

Code Samples

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

FillCornerRadius

UDim

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

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

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

Code Samples

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

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

FillImage

string

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

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

Code Samples

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

FillTransparency

number

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

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

Code Samples

local ProgressBar = script.Parent
ProgressBar.FillTransparency = 0.5

StartAngle

number

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

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

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

Code Samples

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

TrackColor3

Color3

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

Code Samples

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

TrackCornerRadius

UDim

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

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

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

Code Samples

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

TrackImage

string

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

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

Code Samples

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

TrackTransparency

number

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

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

Code Samples

local ProgressBar = script.Parent
ProgressBar.TrackTransparency = 0.5

Value

number

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

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

• 0: 채우기 영역이 표시되지 않습니다.

• 1: 채우기 영역이 모두 표시됩니다.

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

Code Samples

local ProgressBar = script.Parent
ProgressBar.Value = 0.4

Methods

Events

See also

GUIProgressBarFillDirection