GuiButton 은 Class.GuiObject 의 상위 클래스입니다. Class.ImageButton 및 Class.TextButton 의 개체입니다. 이 형식의
GUI 버튼 활성화의 가장 중요한 이벤트는 GuiButton.Activated입니다. 이는 버튼이 활성화되면 발생하는 멀티 플랫폼 이벤트
요약
속성
마우스가 버튼을 자동으로 변경할 때 버튼의 색이 변경되는지 여부를 결정합니다.
GUI 요소가 표시되는 동안 마우스가 잠긴 상태가 아니라면, 마우스가 아래로 스크롤되지 않고 있는 경우에만 마우스가 잠긴 상태로 유지됩니다.If true while the GUI element is visible, the mouse will not be locked unless the right mouse button is down.
개체가 선택되었는지 여부를 나타내는 부울 속성입니다.
미리 정의된 스타일 목록에 따라 GuiButton의 스타일을 설정합니다.
이 UI 요소가 입력을 싱크하는지 여부를 결정합니다.
절대 크기에 대해 GuiObject 의 원래 크기를 결정합니다.
자식 콘텐츠에 따라 크기 조정이 발생하는지 여부를 결정합니다.
Class.GuiObject 배경 색상을 결정합니다.
Class.GuiObject 배경과 경계의 투명도를 결정합니다.
Class.GuiObject 경계의 색을 결정합니다.
크기 축소에 따라 GuiObject 범위의 경계가 어떻게 설정되는지 결정합니다.
Class.GuiObject 범위의 픽셀 너비를 결정합니다.
부모 GUI 요소의 범위 내에서 내려지는 경우 GuiObjects 을 렌더링할지 여부를 결정합니다.
플레이어의 마우스가 GuiObject에 활성적으로 누르고 있는지 여부를 결정합니다.
Class.GuiButton 이 인터랙션 가능한지 여부를 결정하고, GuiState 의 GuiObject 가 변경되었는지 여부를 결정합니다.
Class.UIGridStyleLayout 와 함께 사용할 때 UIGridStyleLayout 의 정렬 순서를 제어합니다.
게임 패드 선택기가 내려지면 선택할 GuiObject 를 설정합니다.
왼쪽 게임 패드 선택기에 배치될 때 GuiObject 를 설정합니다.
오른쪽 게임 패드 선택기에 배치될 GuiObject 를 설정합니다.
게임 패드 선택기가 위로 이동할 때 선택할 GuiObject 설정합니다.
Class.GuiObject의 픽셀 및 스칼라 위치를 결정합니다.
Class.GuiObject가 회전하는 데 사용되는 도 수를 결정합니다.
게임 패드에서 GUI 를 선택할 수 있는지 여부를 결정하십시오.
게임 패드에 사용되는 기본 선택 장식을 재정의합니다.
게임 패드 선택에 의해 선택된 <Class.GuiObject|GuiObjects>의 순서입니다.
Class.GuiObject의 픽셀 및 스칼라 크기를 결정합니다.
Class.GuiObject.Size|Size 축을 설정하면 GuiObject의 부모 크기에 대해 기반을 둔다.
Class.GuiObject.BackgroundTransparency|BackgroundTransparency 및 TextTransparency의 혼합 속성.
Class.GuiObject 및 그 후손이 렌더링될지 여부를 결정합니다.
다른 요소와 비슷한 순서로 GuiObject 렌더링을 결정합니다.
UI 요소의 실제 화면 위치를 픽셀로 설명합니다.
UI 요소의 실제 화면 회전을 정도로 설명합니다.
UI 요소의 실제 화면 크기를 픽셀로 설명합니다.
설정을 사용하면 이 GuiBase2d와 그 후손에 대해 현지화가 적용됩니다.
이 GuiBase2d와 그 후손에 자동화 로컬화를 적용하기 위한 LocalizationTable 참조.
아래로 향하는 게임 패드 선택 동작을 사용자 정의합니다.
왼쪽 방향에서 게임 패드 선택 동작을 사용자 정의합니다.
오른쪽 방향으로 게임 패드 선택 동작을 사용자 정의합니다.
게임 패드 선택 동작을 위쪽으로 사용자 정의합니다.
게임 패드 선택 이동을 사용자 정의할 수 있습니다.
메서드
메서드가 GuiObject에서 상속되었습니다- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
새로운 Datatype.UDim2로 GUI를 부드럽게 이동합니다.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
새로운 Datatype.UDim2로 GUI를 원활하게 조정합니다.
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
새 크기와 위치로 GUI를 부드럽게 이동합니다.
이벤트
버튼이 활성화되면 화재됩니다.
마우스가 완전히 클릭한 상태에서 GUI 버튼을 클릭했을 때 발생합니다.
GUI 개체의 왼쪽 마우스 아래 상태에서 마우스가 있을 때 발생합니다.
왼쪽 마우스가 GUI 개체를 릴리스할 때 발생합니다.
마우스가 GUI 버튼을 완전히 오른쪽 클릭했을 때 발생합니다.
GUI 개체의 오른쪽 마우스 아래 상태에서 마우스가 있을 때 발생합니다.
GUI 개체에서 오른쪽 마우스 버튼이 해제된 때에 발생합니다.
사용자가 인간-컴퓨터 인터페이스 장치(마우스 버튼 다운, 터치 시작, 키보드 버튼 다운 등)를 통해 상호 작용하기 시작하면 발생합니다.
사용자가 인간-컴퓨터 인터페이스 장치(마우스 버튼 다운, 터치 시작, 키보드 버튼 다운 등)를 통해 상호 작용 방식을 변경할 때 발생합니다.
사용자가 인간-컴퓨터 인터페이스 장치(마우스 버튼 아래, 터치 시작, 키보드 버튼 아래 등)를 통해 상호 작용을 중지할 때 발생합니다.
사용자가 마우스를 GUI 요소에 이동하면 화면에 불이 붙습니다.
사용자가 GUI 요소를 떠나면 화면에 나타납니다.
사용자가 GUI 요소 내에 마우스를 이동할 때마다 발생합니다.
마우스가 GUI 요소 위에 있을 때 사용자가 마우스 휠을 돌리면 화면이 나타납니다.
마우스가 GUI 요소 위에 있을 때 사용자가 마우스 휠을 앞으로 스크롤할 때 발생합니다.
Gamepad 선택기로 집중되는 동안 GuiObject가 발생했습니다.
게임 패드 선택기가 GuiObject에 집중하지 않을 때 발생합니다.
플레이어가 UI 요소를 길게 누르면 시작, 계속하기 및 중지합니다.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
플레이어가 UI 요소에 손가락을 이동할 때 화면에 표시됩니다.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
두 손가 UI 요소에 대해 썰매거나 끌기 동작을 수행할 때 화면에 나타납니다.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
두 개의 손가락을 사용하여 UI 요소를 회전하는 플레이어를 발생시킵니다.
플레이어가 UI 요소에서 스와이프 동작을 수행할 때 화면에 나타납니다.
플레이어가 UI 요소에 탭 동작을 수행할 때 발생합니다.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
게임 패드 선택이 이동하거나 떠나거나 연결된 GuiBase2d 또는 모든 하위 GuiObjects 내에서 변경되면 화면에 표시됩니다.
속성
AutoButtonColor
자동 버튼 색상은 사용자의 Mouse 위에 마우스를 올린 경우 버튼이 자동으로 색상을 변경하는지 여부를 결정합니다.
마우스가 버튼을 클릭하거나 마우스가 버튼을 떠나면 버튼의 색이 자동으로 변경됩니다. 만약 거짓이라면 버튼은 변경되지 않습니다.
사용자의 마우스가 버튼을 클릭하거나 마우스를 놓을 때 버튼이 변경되는 방법을 사용자 정의하려면 ImageButton GUI를 사용하고 요소의 ImageButton.HoverImage 및 ImageButton.PressedImage 를 변경하는 것이 좋습니다.
이 속성은 클래스 ImageButton 에 대해 적용되지 않습니다. 이 속성이 클래스 ImageButton.Image 에 설정된 이미지이고 유효하지 않으면 마우스 휘동 시 이미지 버튼 요소에 마우스
코드 샘플
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = trueModal
GUI 요소가 표시되는 동안 마우스가 잠긴 상태가 아니라면, 마우스가 아래로 스크롤되지 않고 있는 경우에만 마우스가 잠긴 상태로 유지됩니다.If true while the GUI element is visible, the mouse will not be locked unless the right mouse button is down.
메서드
이벤트
Activated
버튼이 활성화되면 발생합니다. 이 이벤트는 서버에서 발생하지 않으므로 LocalScript 또는 Script 에 RunContext 만 사용해야 합니다. 2>Class.Script2> 의 5>Class.Script.RunContext5> 에 8>Class.Script8> 만
매개 변수
MouseButton1Click
MouseButton1Click 이벤트는 사용자의 Mouse 가 GUI 버튼을 완전히 왼쪽으로 클릭할 때 발생합니다.
마우스가 버튼의 경계 내에 있어야 하며 이 이벤트가 발생하기 전에 다시 누르고 마우스를 아래로 또는 위로 누르고 다시 누르는 것이 필요합니다. 마우스가 버튼의 경계를 벗어나 버튼을 떠나면 이벤트가 발생하
이 이벤트는 GuiButton.MouseButton2Click 와 유사하지만, 사용자의 오른쪽 마우스 버튼에 연결되지 않고 동일하게 동작합니다.
이 이벤트는 다음을 포함한 GUI 버튼만 발생합니다. TextButtons 및 ImageButton . GuiObjects 에 대해서는 발생하지 않습니다.
코드 샘플
local button = script.Parent
local function leftClick()
print("Left mouse click")
end
local function rightClick()
print("Right mouse click")
end
button.MouseButton1Click:Connect(leftClick)
button.MouseButton2Click:Connect(rightClick)MouseButton1Down
MouseButton1Down 이벤트는 사용자가 GUI 개체에서 왼쪽 Mouse 버튼을 눌렀을 때 발생합니다.
이 이벤트는 GuiButton.MouseButton2Down 와 유사하지만, 사용자의 오른쪽 마우스 버튼에 연결되지 않고 동일하게 동작합니다.
이벤트에서 사용자가 왼쪽 마우스를 누르고 릴리스해야 하는 이벤트를 검색하는 경우 GuiButton.MouseButton1Click 를 사용하는 것이 좋습니다.
이 이벤트는 다음을 포함한 GUI 버튼만 발생합니다. TextButtons 및 ImageButton . GuiObjects 에 대해서는 발생하지 않습니다.
매개 변수
코드 샘플
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton1Up
MouseButton1Up 이벤트는 사용자가 GUI 개체 밖으로 왼쪽 Mouse 을 릴리스할 때 발생합니다.
이 이벤트는 GuiButton.MouseButton2Up 와 유사하지만, 사용자의 오른쪽 마우스 버튼에 연결되지 않고 동일하게 동작합니다.
이벤트에서 사용자가 왼쪽 마우스를 누르고 릴리스해야 하는 이벤트를 검색하는 경우 GuiButton.MouseButton1Click 를 사용하는 것이 좋습니다.
이 이벤트는 다음을 포함한 GUI 버튼만 발생합니다. TextButtons 및 ImageButton . GuiObjects 에 대해서는 발생하지 않습니다.
매개 변수
코드 샘플
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton2Click
MouseButton2Click 이벤트는 사용자의 Mouse 가 GUI 버튼을 완전히 오른쪽으로 클릭할 때 발생합니다.
마우스가 버튼의 경계 내에 있어야 하며 이 이벤트가 발생하기 전에 다시 누르고 마우스를 아래로 또는 위로 누르고 다시 누르는 것이 필요합니다. 마우스가 버튼의 경계를 벗어나 버튼을 떠나면 이벤트가 발생하
이 이벤트는 GuiButton.MouseButton1Click 와 유사하지만, 사용자의 왼쪽 마우스 버튼에 연결되지 않고 동일하게 동작합니다.
이 이벤트는 다음을 포함한 GUI 버튼만 발생합니다. TextButtons 및 ImageButton . GuiObjects 에 대해서는 발생하지 않습니다.
코드 샘플
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
MouseButton2Down 이벤트는 사용자가 GUI 개체에서 오른쪽 버튼을 아래로 누르면 발생합니다.The MouseButton2Down event fires when the user presses their right Mouse button down on the GUI object.
이 이벤트는 GuiButton.MouseButton1Down 와 유사하지만, 사용자의 왼쪽 마우스 버튼에 연결되지 않습니다.
이벤트에서 사용자가 마우스 오른쪽 버튼을 누른 다음 해제해야 이벤트가 발생하도록 하려면 GuiButton.MouseButton2Click 를 사용하십시오.
이 이벤트는 다음을 포함한 GUI 버튼만 발생합니다. TextButtons 및 ImageButton . GuiObjects 에 대해서는 발생하지 않습니다.
매개 변수
코드 샘플
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)
MouseButton2Up
MouseButton2Up 이벤트는 사용자가 GUI 개체 밖으로 오른쪽을 내려 놓을 때 발생합니다.The MouseButton2Up event fires when the user releases their right Mouse out of the GUI object.
이 이벤트는 GuiButton.MouseButton1Up 와 유사하지만, 사용자의 왼쪽 마우스 버튼에 연결되지 않습니다.
이벤트에서 사용자가 마우스 오른쪽 버튼을 누른 다음 해제해야 이벤트가 발생하도록 하려면 GuiButton.MouseButton2Click 를 사용하십시오.
이 이벤트는 다음을 포함한 GUI 버튼만 발생합니다. TextButtons 및 ImageButton . GuiObjects 에 대해서는 발생하지 않습니다.
매개 변수
코드 샘플
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)