# ImageButton

ImageButton : `GuiButton`

## Overview

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

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

## Properties

### HoverImage

`string`

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

#### Code Samples

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

ImageButton.HoverImage = "ovdrassetid://1234"
```

### HoverImageContent

`Content`

현재 지원되지 않습니다.

#### Code Samples

### Image

`string`

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

#### Code Samples

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

ImageButton.Image = "ovdrassetid://1234"
```

### ImageColor3

`Color3`

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

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

#### Code Samples

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

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

### ImageContent

`Content`

현재 지원되지 않습니다.

#### Code Samples

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

ImageButton.ImageContent = "Complete content data here"
```

### ImageTransparency

`number`

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

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

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

#### Code Samples

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

ImageButton.ImageTransparency = 0.5
```

### PressImage

`string`

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

#### Code Samples

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

ImageButton.PressImage = "ovdrassetid://1234"
```

### PressImageContent

`Content`

현재 지원되지 않습니다.

#### Code Samples

## Methods

## Events

## See also

{% content-ref url="../../../manual/studio-manual/gui" %}
[gui](https://docs.overdare.com/korean/manual/studio-manual/gui)
{% endcontent-ref %}