ImageButton

ImageButton : GuiButton

Overview

ImageButton은 이미지 표시 방식은 ImageLabel과 같지만, 버튼으로서의 상호작용 기능이 더해진 형태입니다. 즉, 이미지를 표시하면서도 클릭·터치 같은 GuiButton의 이벤트를 사용할 수 있는 UI 요소입니다.

ImageButton은 클라이언트 환경에서만 제어할 수 있습니다.

Properties

HoverImage

string

ImageButton에 마우스 커서가 올라갔을 때(호버 상태) 표시할 이미지 에셋을 지정합니다.

Code Samples

local ScreenGui = script.Parent
local ImageButton = ScreenGui:WaitForChild("ImageButton")

ImageButton.HoverImage = "ovdrassetid://1234"

Image

string

ImageButton에 표시할 이미지 에셋을 지정합니다.

Code Samples

local ScreenGui = script.Parent
local ImageButton = ScreenGui:WaitForChild("ImageButton")

ImageButton.Image = "ovdrassetid://1234"

ImageColor3

Color3

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

색을 흰색으로 두면 원본 이미지가 그대로 표시되며, 다른 색을 지정하면 이미지 전체에 그 색조가 입혀집니다.

Code Samples

local ScreenGui = script.Parent
local ImageButton = ScreenGui:WaitForChild("ImageButton")

ImageButton.ImageColor3 = Color3.fromRGB(255, 0, 0)

ImageTransparency

number

이미지의 투명도를 지정합니다.

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

배경을 숨기고 이미지만 표시하고 싶다면 BackgroundTransparency를 1로 설정하면 됩니다.

Code Samples

local ScreenGui = script.Parent
local ImageButton = ScreenGui:WaitForChild("ImageButton")

ImageButton.ImageTransparency = 0.5

PressImage

string

ImageButton이 눌렸을 때 표시할 이미지 에셋을 지정합니다.

Code Samples

local ScreenGui = script.Parent
local ImageButton = ScreenGui:WaitForChild("ImageButton")

ImageButton.PressImage = "ovdrassetid://1234"

ScaleType

Enum.ScaleType

UI 요소의 크기가 원본 이미지와 다를 때 이미지를 어떻게 조정할지 지정합니다.

• Stretch: 이미지를 요소의 크기에 맞게 늘립니다. 기본값입니다.

• Slice: 이미지를 아홉 개의 영역으로 나누고 각 영역에 서로 다른 조정 규칙을 적용합니다. 슬라이스 경계는 SliceCenter로 결정됩니다. Slice로 설정하면 SliceCenter와 SliceScale 속성이 함께 표시됩니다.

Code Samples

local ScreenGui = script.Parent
local ImageButton = ScreenGui:WaitForChild("ImageButton")

ImageButton.ScaleType = Enum.ScaleType.Slice

SliceCenter

Rect

ScaleType이 Slice일 때 아홉 개 영역의 슬라이스 경계를 지정합니다.

값은 이미지 좌상단(0, 0)을 기준으로 한 절대 픽셀 좌표이며, 좌상단 지점 Min과 우하단 지점 Max로 구성됩니다. Properties 창에는 X0, Y0, X1, Y1 네 개의 필드로 표시되며 각각 Min.X, Min.Y, Max.X, Max.Y에 대응합니다.

Code Samples

local ScreenGui = script.Parent
local ImageButton = ScreenGui:WaitForChild("ImageButton")

ImageButton.ScaleType = Enum.ScaleType.Slice
ImageButton.SliceCenter = Rect.new(10, 10, 118, 118)

SliceScale

number

ScaleType이 Slice일 때 슬라이스 테두리를 지정한 비율로 확대합니다.

Code Samples

local ScreenGui = script.Parent
local ImageButton = ScreenGui:WaitForChild("ImageButton")

ImageButton.ScaleType = Enum.ScaleType.Slice
ImageButton.SliceScale = 2

Methods

Events

See also

GUI