UIStroke

UIStroke : Instance

Overview

UIStroke는 부모 UI 오브젝트의 경계 또는 텍스트 외곽에 선을 표시하는 기능을 제공하는 오브젝트입니다. 선의 색상, 두께, 투명도, 표시 위치와 모서리 연결 형태 등을 설정하여 UI 요소를 강조하거나 시인성을 높일 수 있습니다.

UIStroke는 Frame, TextLabel 등 외곽선을 적용할 UI 오브젝트의 자식으로 배치하여 사용할 수 있습니다.

Properties

ApplyStrokeMode

Enum.ApplyStrokeMode

부모 UI 요소에 선을 적용하는 방식을 지정합니다.

• Border: 부모 UI 요소의 경계를 따라 선을 표시합니다.

• Contextual: 부모 UI 요소의 유형에 따라 적절한 영역에 선을 표시합니다. 텍스트 UI 요소에서는 텍스트 외곽에 선이 표시됩니다.

Contextual는 TextLabel이나 TextButton 같은 텍스트 UI 요소에서만 설정할 수 있습니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.ApplyStrokeMode = Enum.ApplyStrokeMode.Border

BorderOffset

UDim

부모 UI 요소의 경계를 기준으로 외곽선의 위치를 조정합니다.

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

이 속성은 부모 UI 요소의 경계에 선을 표현할 때만 지정할 수 있습니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.BorderOffset = UDim.new(0, 10)

BorderStrokePosition

Enum.BorderStrokePosition

부모 UI 요소의 경계를 기준으로 선이 표시되는 위치를 지정합니다.

• Inner: 경계 안쪽에 선을 표시합니다.

• Center: 경계를 중심으로 선을 표시합니다.

• Outer: 경계 바깥쪽에 선을 표시합니다.

이 속성은 부모 UI 요소의 경계에 선을 표현할 때만 지정할 수 있습니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.BorderStrokePosition = Enum.BorderStrokePosition.Outer

Color

Color3

선에 적용되는 색상을 지정합니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")
UIStroke.Color = Color3.fromRGB(255, 0, 0)

Enabled

boolean

선의 표시 여부를 지정합니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.Enabled = false

LineJoinMode

Enum.LineJoinMode

선이 모서리에서 연결되는 형태를 지정합니다.

• Round: 모서리를 둥근 형태로 연결합니다.

• Bevel: 모서리를 비스듬히 잘라낸 형태로 연결합니다.

• Miter: 모서리를 뾰족한 형태로 연결합니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.LineJoinMode = Enum.LineJoinMode.Round

StrokeSizingMode

Enum.StrokeSizingMode

부모 UI 요소의 크기가 변경될 때 선의 두께를 계산하는 방식을 지정합니다.

• FixedSize: 부모 UI 요소의 크기와 관계없이 일정한 두께를 유지합니다.

• ScaledSize: 부모 UI 요소의 크기에 비례하여 선의 두께를 조정합니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.StrokeSizingMode = Enum.StrokeSizingMode.FixedSize

Thickness

number

선의 두께를 지정합니다.

값이 클수록 선이 더 두껍게 표시됩니다. 실제 표시 결과는 StrokeSizingMode 설정의 영향을 받을 수 있습니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.Thickness = 5

Transparency

number

선의 투명도를 지정합니다.

0은 완전한 불투명 상태를 의미하고, 1은 전혀 보이지 않는 상태를 의미합니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.Transparency = 0.5

ZIndex

number

선이 다른 UIStroke와 겹칠 때 적용되는 표시 우선순위를 지정합니다.

값이 클수록 더 높은 우선순위로 표시됩니다.

이 속성은 부모 UI 요소의 경계에 선을 표현할 때만 지정할 수 있습니다.

Code Samples

local TextLabel = script.Parent
local UIStroke = TextLabel:WaitForChild("UIStroke")

UIStroke.ZIndex = 10

Methods

Events

See also

GUI