GuiButtons는 플레이어가 행동을 수행할 수 있게 해주는 GuiObjects입니다. 이러한 버튼을 사용자 정의하여 시각적 외관을 변경하거나 플레이어가 버튼과 상호작용할 때 스크립팅 오디오 피드백을 제공하는 등의 맥락과 피드백을 제공할 수 있습니다.
화면 온스크린 또는 인게임에 배치할 수 있는 두 가지 유형의 버튼이 있습니다:
TextButton은 클릭/탭 시 Activated 및/또는 SecondaryActivated 이벤트를 트리거하는 텍스트가 있는 사각형입니다.
ImageButton은 클릭/탭 시 Activated 및/또는 SecondaryActivated 이벤트를 트리거하는 이미지가 있는 사각형입니다. 플레이어가 마우스를 올리거나 누를 때 이미지를 교체하는 추가 상태가 있습니다.
화면의 버튼
화면 버튼은 플레이어를 다양한 메뉴나 페이지로 빠르게 안내하는 데 유용합니다. 이 유형의 버튼을 추가하려면:
Explorer 창에서 StarterGui 위에 마우스를 올리고 ⊕ 버튼을 클릭한 다음 ScreenGui를 삽입합니다.
새로 생성된 ScreenGui 위에 마우스를 올리고 ⊕ 버튼을 클릭한 다음 TextButton 또는 ImageButton을 삽입합니다.
파트 면의 버튼
파트에 있는 버튼은 플레이어가 파트와 상호작용할 수 있게 해줍니다. 예를 들어, 플레이어가 버튼 위에 서서 행동을 완료하도록 할 수 있습니다.
파트의 면에 버튼을 추가하려면:
Explorer 창에서 파트 위에 마우스를 올리고 ⊕ 버튼을 클릭한 다음 SurfaceGui를 삽입합니다.
새로 생성된 SurfaceGui 위에 마우스를 올리고 ⊕ 버튼을 클릭한 다음 TextButton 또는 ImageButton을 삽입합니다.
버튼 외관
TextButton과 ImageButton은 GuiObject에서 상속되며, BackgroundColor3, Rotation, 및 Size와 같은 속성을 포함합니다. 버튼은 또한 대부분의 UI 객체에 공통적인 외관 수정자를 수용합니다.
TextButton에 고유한 다양한 속성이 있어 시각적 외관을 변경할 수 있습니다:
- FontFace — 텍스트를 렌더링하는 데 사용되는 글꼴입니다.
- Text — 버튼에 렌더링되는 텍스트 문자열입니다.
- TextSize — 오프셋으로 된 텍스트의 줄 높이입니다.
- TextColor3 — 렌더링된 텍스트의 색상입니다.
ImageButton은 플레이어의 버튼 상호작용을 나타내기 위해 호버 및 눌림 이미지 변형을 포함하여 시각적 외관을 변경하는 여러 속성을 가지고 있습니다:
- Image — 플레이어가 ImageButton과 상호작용하지 않을 때 표시되는 이미지입니다.
- HoverImage — 플레이어가 ImageButton 위에 커서를 올릴 때 표시되는 이미지입니다.
- PressedImage — 플레이어가 ImageButton을 클릭/탭할 때 표시되는 이미지입니다.
스크립트 버튼
플레이어가 버튼을 누를 때 행동을 스크립트할 수 있으며, 버튼을 GuiButton.Activated 이벤트에 연결하거나 데스크탑의 오른쪽 클릭 및 모바일의 긴 누름과 같은 크로스 플랫폼 보조 입력을 위해 GuiButton.SecondaryActivated에 연결할 수 있습니다. 예를 들어, 다음 LocalScript를 버튼에 부모로 설정하면 플레이어가 버튼을 클릭/탭할 때마다 버튼이 무작위 색상으로 변경됩니다.
local button = script.Parent
local RNG = Random.new()
local function onButtonActivated()
-- 버튼 색상 무작위화
button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end
button.Activated:Connect(onButtonActivated)