# 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"
```

### 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)
```

### 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"
```

## Methods

## Events

## See also

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/classes/imagebutton.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.